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Welcome 


WELCOME TO 
THE OFFICIAL 
MAGAZINE 


e’ve been waiting to go all in on Android 

for a long time. We’ve all used Google’s 
mobile operating system, and the prospect 
of having a Raspberry Pi running Android is just too 
good to miss (page 16). The unofficial solution is a bit 
‘creative’, but we think it’s tons of fun. 

Speaking of creativity: the UK weather has always 
been a bit bonkers, but lately it’s gone full-blown 
bizarre. When it’s not blazing hot, it’s stormy, 
or chilly, and only a few months back we were in SUBSCRIBE 
the depths of a bleak midwinter. We wouldn’t be 
surprised by frogs at this rate. 

So we are delighted to share Raspberry Pi’s new 
Weather Station instructions (page 70). Building 
your own weather station is an amazing summer 


project, and the output is a perfect introduction to 
measuring data. THIS MONTH: 


We’ve also got some extra-neat projects this 
16 ANDROID ON RASPBERRY PI 


month, including the Seeing Wand (page 30) and 
Get Google's OS up and running 


gic: THE 
MA HERING 


puiLo A 


MAGIC; THE 
GATHERING 


SEE PAGE 28 FOR DETAILS 


the Magic: The Gathering card analysis machine 
(page 34). Both use AI to push the Raspberry Pi 


further than we thought possible. If you are getting 
into Al, then don’t forget to install TensorFlow on a 44 BUILD AN OSCILLOSCOPE 
Measure signal voltage with a Raspberry Pi 

Raspberry Pi (page 58). 

There’s a lot to get stuck into this month, so let’s 58 INSTALL TENSORFLOW 
get started. Get started with Google's Al framework 
Lucy Hattersley 70 MAKE A WEATHER STATION 
Editor Come rain or shine, you'll know what's up 
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Break another record! 


Some of the tools and techniques shown in The MagPi magazine are dangerous unless used with skill, experience, and appropriate personal protection equipment. While we 
attempt to guide the reader, ultimately you are responsible for your own safety and understanding the limits of yourself and your equipment. Children should be supervised. 
Raspberry Pi (Trading) Ltd does not accept responsibility for any injuries, damage to equipment, or costs incurred from projects, tutorials or suggestions in The MagPi 
magazine. Laws and regulations covering many of the topics in The MagPi magazine are different between countries, and are always subject to change. You are responsible 
for understanding the requirements in your jurisdiction and ensuring that you comply with them. Some manufacturers place limits on the use of their hardware which some 
projects or suggestions in The MagPi magazine may go beyond. It is your responsibility to understand the manufacturer's limits. 
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Build a Pi-powered weather station 


We've got four AstroBox kits up for grabs 
to control your 3D printer from anywhere! 
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News 


CROWPI 


FLIES PAST ITS 


The case for hacking and making 


Below Plug in 

the power bank 
accessory and you 
can use CrowPi like 
a laptop or portable 
hacking station 
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hinese outfit Elecrow’s 
latest project is a briefcase 
full of everything a 
hardware hacker and digital 
maker needs, from circuit boards 
and sensors to an integrated 
touchscreen display. 

CrowPi crams a big bundle of 
electronics into its hard-shell carry 
case, and is compatible with all 
versions of Pi 2, Pi3, and Pi Zero. 
The case comes in four colours: 
black, purple, blue, and yellow. 
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KICKSTARTER 
CAMPAIGN GOAL 


Among the fairly standard 
fare such as sensors for light, 
motion, and sound you will 
find various readout devices, 
an RFID sensor, an ultrasonic 
Sensor, servo interfaces, a step 
motor connection, and a GPIO 
LED indicator. 

This panel helps debug 
circuits, as Elecrow sales and 
marketing manager Jarvan 
explains, “The status LED 
indicates when a sensor if working 


~ 


and how, [which] gives you a 
better understanding of how 
microelectronics work.” 

Elecrow worked hard to “choose 
the most common and project- 
orientated sensors” to include, 
Jarvan reveals, but had to “make 
sure we can fit as many sensors as 
possible” into the Elecrow case. 

Jarvan adds, “We’ve tested a 
lot of LCD screens [to] choose 
the most suitable one, and even 
left some space [above] for the 
Raspberry Pi camera.” 


Crow funding 
Jarvan tells us that “the Elecrow 
philosophy is ‘make your making 
easier’”’, and this belief isn’t just 
represented in how CrowPi brings 
together so much hardware, but in 
its documentation too. 

“We’ve been working very 
hard writing those tutorials,” 
says Jarvan, modifying the 
documentation “hundreds of 
times in order to be as simple 
and understandable as possible.” 
This makes CrowPi as useful 
for schools and clubs as for 
individuals wanting a neat kit 
to develop code or hardware, 
according to Jarvan. 

CrowPi runs a standard 
installation of Raspbian, with only 
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the “basic drivers [required] in order 
for our hardware to operate right 
out of the box,” Jarvan confirms. 
“We wanted to modify the Raspbian 
image as little as possible, to keep 
the right for the customer to choose 
what they want.” 


Elecrow intends to sell 
CrowPi units through its website, 
elecrow.com, and Jarvan confirms a 
possibility “to sell it on our Amazon 
or AliExpress store.” 

For more details, visit the CrowPi 
Kickstarter page: magpi.cc/oUFbTt. 


The Elecrow philosophy 1s 
make your making easier 


A basic, Pi-less unit costs $229 
(£170), while the $369 (£275) 
Advanced Kit includes a Pi 3B+, a 
built-in camera, two gamepads, 
and a wireless keyboard and 
mouse, plus a few other hardware 
configurations to select. As 
Elecrow has its own production 
line, Jarvan says “delivery time 
and quality is guaranteed.” 


CrowPi 
comes in four 
colours and a 
few different 
hardware 
configurations, 
so you can 
choose which 
suits you best 


eaeseeeens y 


Elecrow is based in Shenzhen City, 
China, the electronics capital of the 
world. Sales and marketing manager 
Jarvan was keen to point out the 
advantages of Elecrow’'s production 


line and gave us some glimpses 
of the process. 


You can see the RFID contact pad to 
the lower left of the CrowPi circuit 
board. RFID can be a fun and useful 
way to trigger events using an Android 
phone, or newer model iPhone. 


The buttons can be programmed to do 
Whatever you like - the cluster might 
be used as a keypad while the four to 
the left could control a character ina 
self-made game. 
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REVERSE-EMULATED 


Pi plays SNES games on rf it 
unmodified NES Pg) et OF 


Pa Xi-X-x-) 9 
mulation is the process The project 
. requireda 
of running older software pechene circuit 
on newer, incompatible board, housing 
hardware, but Tom Murphy VII, lasbicea ech 
a reprogrammed 
a computer scientist from NES PPU chip, 
. and a Nintendo 
Pittsburgh, PA, wanted to turn Be ania 
that process on its head by protection chip 


‘reverse-emulating’ a SNES. 

The basic idea was to run SNES 
games on a NES, to tell a joke 
based on what Tom calls ‘improper 
hierarchy’. It’s not funny to run old 
software on new hardware, because 
software is meant to get better over 
time and older hardware is meant 
to become obsolete. However, 

Tom contends that it is funny 


to run newer software on older l prefer tO think of it like an Tom 


hardware, because that’s just an originally used 
a Pi Zero W, but 


absurd thing to do, or an example qb surdly advanced memory found ita little 


of ‘improper hierarchy’. slow for the task 
so upgraded 


Pe eee OS mapper within the cartridge patiaie tie 


emulation was to somehow fool 
an unmodified NES into running 


Eee SiMle,s Hemvare 9) anole Sworn an absurdly advanced ‘memory 

Mario World, which he achieved mapper’ within the cartridge,” 

by embedding a Raspberry Pi 3 Tom tells us. 

into a NES game cartridge. The While Tom admits that he might 

Pi emulated the SNES game, but have had an easier build by using a 

then had to convert the graphics bespoke microcontroller, he reveals 

into aform that the NES hardware _ that he used a Raspberry Pi so “I 

could display. can have my whole development 
As Tom clarifies for us, the Pi is environment right on the device.” 


acting “kind of likeadownsampler, Rather than “swapping chips intoa 
although the SNES pixel resolution programmer, or even attaching an 


is actually the same as the NES, ICSP cable,” Tom continues, the Pi 
so it’s not downsampling in that “really shortens the edit/compile/ 
spatial sense.” Instead, the Pi has test cycle.” 

to convert the larger numbers of Tom explains the many 

colours in the SNES game into technical issues he had to solve 
the limited colour palette of the in his fascinating video at 

NES. “1 preter to think of it like youtu.be/argWRwCiSro. 
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CDP Studio is a development platform for industrial control systems, now coming with a free 
version for non-commercial use. The system can run on a Raspberry Pi, supports C++, open source 
libraries and has a large feature toolbox including GPIO, I2C and MQTT. Its built in GUI design tool 


and features lets you code less and do more. 


Free download on 


CDP Technologies AS 
Nedre Strandgate 29 


P.O. Box 144 


NO-6001 Alesund, Norway 


Tel: +47 990 80 900 
info@cdptech.com 


www.cdpstudio.com 
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MOONHACK 


018 


his year’s Moonhack will 

be even bigger than before, 

with an estimated 50 000 
kids completing challenges and 
running projects to explore space 
on 20 July. 

As Nicola Curnow, national 
programme manager at Code Club 
Australia reveals, “We’re setting 
a world record, inviting every kid 
in the world to give coding a go, 
or impress us with their skills. 
[...] Last year we had 28575 kids 
from more than 50 countries 
participating; we’re aiming for 
50000 kids this year.” 


Help break a coding 
world record 


You can register for Moonhack 
at moonhack.com to get your 
school, library, Code Club, 
CoderDojo, or your family 
involved, but the nature of the 
projects is still “top secret stuff 
says Nicola. However, she tells us 
“The whole Moonhack campaign 
is designed to be super-accessible, 
so there is no hardware required 
to participate.” 

Moonhack projects are all 
Space-themed, as the event 
celebrates the Apollo 11 
moon landing. Stay informed 
via #moonhack. 


|» 


_eft Join the 
anticipated 50000 
Moonhackers 
worldwide at 
moonhack.com 


MODULAR MAKING 


A LEGO kit for electronics 


ibbo Technology’s Tibbo power relays to audio converters 
Project System (TPS) to real-world sensors, you should 
has been around for four be able to construct almost any 
@ c00® 9 coe | =<) fea | years, but it’s finally coming tothe project as quickly as a basic 
Abi Te 75:38 @°5330 ueceh Raspberry Pi. LEGO model. 


Rather than using breadboards 
or soldering, the TPS uses 
Tibbit blocks to “implement 
an I/O function” by plugging 
them into a TPS ‘mainboard’ 
(motherboard). Announced at are alternatives. 
this year’s Computex technology An English brochure for Tibbo-Pi 
show in Taiwan, there willsoonbe is planned, available through 
a mainboard that incorporates a co-works.jp/tibbo-pi, but this site 
Raspberry Pi 3. is in Japanese. However, Tibbo’s 

It is unclear whether the Pi 3B+ main site lists all the currently 
will be supported, but with 60 available Tibbits in English — 
Tibbit blocks to add anything from see tibbo.com. 


Details are still in the process 
of translation, but Tibbo confirms 
that Node-RED (VJavaScript) is 
the standard coding language for 
Tibbo-Pi, and that C and Python 


Above Connect the modular Tibbits to the mainboard to prototype 
your hardware as easily as building a simple LEGO model 
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ON A PI 


Major update to RaspAnd brings 
Bluetooth and better wireless 


new release of the RaspAnd automatically reconnects after 

operating system brings Vein) TEBOW. 

Android Nougat to the RaspAnd includes Google Play 
Raspberry Pi 3B, preloaded with Services and the Play Store, 
apps such as TeamViewer, Kodi, meaning you have full access to 
and Aptoide TV. 

RaspAnd is developed by Swedish This includes the recommended 


outfit Exton Linux (exton.se), with version 4.6 of Spotify and version 


modifications made to allow better 18.0-Alphaz2 of Kodi. 


RaspAnd Nougat 7.1.2 
incorporates Bluetooth 


support and compatibility with 
standard Raspberry Pi hardware. 
Alas, only the Pi 3B is supported at 
this time — the Pi 3B+ is not. 

Crucially, RaspAnd Nougat 7.1.2 
incorporates Bluetooth support prefer. Then follow the advice 
for the first time, as wellasa on RaspAnd’s information page: 
‘stable’ wireless connection which magpi.cc/ATERWF. 


To install RaspAnd, you need 
to download the image from 
magpi.cc/SALgip, which costs 
S9, and burn it to a microSD card 
using whichever method you 


RaspAnd is an easy way to deploy Google's Android OS on your Raspberry Pi 3B 
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NOUGAT 


any app hosted on the main store. 


The stories we shared 
that flew around the world 


magpi.cc/dUGpoR 


Peter Juett’s project uses standard components to show 
information such as weather and air quality, and allows 
you to control smart lights and other loT devices such as 
WeMo smart plugs. 


magpi.cc/gPUAnS 


Google's NSynth system uses Al learning algorithms 
to create new sounds based on samples of musical 

instruments. The NSynth Super houses this next-gen 
synth in a touchscreen device you can build yourself. 


ESTIVAL OF DIGITAL 
CAMBRIDGE, UK ——— 


30 JUNE - 1 JULY 2018 


magpi.cc/xwwGPL 


Come to the first annual festival of technology 
and science, held at Cambridge Junction over the 
weekend of 30 June and 1 July. Highlights include 
brewing a magic potion and Museum in a Box. 


July 2018 VWcgPi 


('(ZTVE HIGH-ALTITUDE RASPBERRY PI GLIDER 


HIGH-ALTITUDE 


RASPBERRY PI 


GLID 


Effortless HAB data recovery 


zzy Brand, a student at 
Brown University, USA, 
created a clever system 

to recover the data from his 
high-altitude balloon (HAB). 
Rather than use a parachute and 
eeolocator, he instead fitted the 
data module to a glider set to land 
at preprogrammed co-ordinates. 

Izzy reveals, “I had the idea 
a long time ago — maybe early 
high school (2013).” Initially the 
idea was just to find a way to fly a 
elider, dropping it from a hot-air 
balloon, as Izzy’s “nearby hills 
weren’t steep enough.” 

The glider uses a Raspberry 
Zero W and a Pixhawk, a flight 
controller powered by an ARM 
processor. “I chose the Zero W,” 
Izzy explains, “because it can run 
MAVProxy, essentially a terminal 
version of the GUI-based ground 
station software used to control 
the Pixhawk.” Izzy chose the 
Pixhawk due to his familiarity with 
its predecessor, the ArduPilot. 

At10000m, the Zero W turned 
on the autopilot mode and 
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“triggered a solid-state relay to 
burn the nickel-chromium wire 
and release the glider.” 


Guided landing 

Izzy explains that the Pixhawk 
module’s autopilot mode operates 
ona system of waypoints, so he set 
“only one waypoint co-ordinate at 
the target landing location, with 
an elevation of zero.” 


was waiting just 10m from the 


yr 


Left Izzy's glider isn't 
anything fancy —- 
mainly foam board and 
corrugated plastic, 
with handwarmers to 
keep the electronics 
inside from freezing 


\ ‘ 
\- A 


Above The day of 
the launch, using a 
$60 military surplus 
sounding balloon to 
send the glider into 
the atmosphere 


target location. 
“We were astonished,” Izzy 
tells us. “This project failed 


I had the idea a long time ago — 
maybe early high school (2013) 


In addition, the Pixhawk doesn’t 
have a glider mode, so Izzy had to 
“set the maximum ascent angle 
to zero so the glider wouldn’t 
try to climb without a motor and 
thereby stall.” 

Amazingly, after launching the 
balloon and driving to the landing 
site 122 miles away, the glider 


miserably in 2015, [as] the glider 
landed in a forest about ten miles 
from its target.” 

Izzy would like to thank his 
friends Luke Fisher and Nick Menz 
for their help “in testing the glider 
and on the launch day.” You can 
find the source code and flight logs 
at magpi.cc/qkqKXj. 
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NEW COMPUTER SCIENCE COURSE FOR IRISH SECONDARY SCHOOLS fiy(277)) 


NEW COMPUTER SCIENCE COURSE FOR 


SCHOOLS | 


Computer Science Teachers’ 
Association of Ireland helps 
schools prepare 


he third element of the Irish government’s 
computer science curriculum will be trialled in 


Association of Ireland (CSTAI) is ready with resources 
to help teach the new Leaving Certificate, Computer 
Science course. 

Following the previous Junior Certificate short 
courses in Coding and Digital Media Literacy, the new 
course aims to “develop an appreciation of the diverse 
roles of computing technology in society and the 
environment in which [students] live,” according to 
CSTAI President Stephen Murphy. 

The course specification outlines that “embedded 
systems (such as the Raspberry Pi) will play a central 
role in the practical component of this subject,” 
explains Stephen. 

He tells us that “over 200 schools applied for the 
Leaving Certificate, Computer Science pilot scheme,” 
of which 40 were selected. The Leaving Certificate, 
Computer Science “will open as an elective subject for 
all schools to offer if they so wish” in September 2020. 


—- Computer Science Teachers’ 


Lv Association of Ireland W 


tener Sign Aen od re Seen Sa Amon of te 


Riomheol Oidi na hEireann 


Above The CSTAI supports teachers of computer science, coding, 
and digital media literacy 


Supporting teachers 

While the Irish government has been described 

as providing “excellent” support for teachers 
wishing to teach any of the three courses, the CSTAI 
supplements that with “hundreds of teaching 
resources (PowerPoints, worksheets, videos, etc.) for 
coding, computer science, digital media, and general 
computing courses,” Stephen reveals. 

Access to these resources is free for CSTAI 
members; to become a member, visit magpi.cc/dTiylU 
or email president.cstai@gmail.com. 

The CSTAI was founded in November 2017 and has 
“over 440 members from Ireland, UK, New Zealand, 
and Dubai,” says Stephen. 
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September, and the Computer Science Teachers’ 


IRISH SECONDARY 


SN. 


Below The CSTAI collaborates with other organisations, 
including CoderDojo; CSTAI President Stephen Murphy 
meets CoderDojo's Tara McGrath and the team from 
the Cork Institute of Technology CoderDojo 


a DEXTER 


N DUS T R 


GoPiGo 


20+ new projects for your Pi robot car. 


BrickPi3 


LEGO MINDSTORMS + RASPBERRY PI 


www.dexterindustries.com 
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© www.pi-top.com 


pi-top 


Inspiring Inventors and creators to 
seek the skills of tomorrow and 
create their Future, today. 


The modular laptop with sliding keyboard 


Q ©® © a 


8HR BATTERY 14” FULL HD 180° CUSTOM MODULAR 
LIFE 1080P SCREEN HINGE PASSIVE COOLING RAIL 
BRIDGE 


The modular desktop 


i 
Pall K 
14” FULL HD MODULAR ADJUSTABLE 
1080P SCREEN RAIL VIEWING ANGLES 


ereenenann 
ereeeueane 
TEUDERALAAS 


pi-topPROTO pi-topSPEAKER pi-topPULSE 


© @GetPiTop 


@ /GetPiTop 


eS RASPBERRY PI 


a n~sTveE 


OCR 


Oxford Cambridge and RSA 


pi-top 
Colors is 
Raspberry Pi 3 optional 


AWESOME INVENTOR’S KIT INCLUDED 
20+ projects 
to explore 


Explore beyond the screen and keyboard by 
creating with the all-new pi-top modular Laptop. 


Get started with 20+ inventions in the inventor’s 
guide booklet. There are 3 inventor's journeys - 
Smart Robot, Music Maker and Space Race. 


pi-topCEED 


Colors 
Raspberry Pi 3 optional 


pi-topCEED is the plug & play modular 
desktop. It's the easiest way to use your 
Raspberry Pi. We've put what you love 
about our flagship laptop in a slimmer 
Form factor. Join hundreds of code clubs 
and classrooms using pi-topCEED as 
their solution to Computer Science and 
STEAM-based learning. 


Modular 
Accessories 


Stay up to date with our Latest news by following our social media 


pi-top is an award-winning ecosystem designed to make 
experimenting, coding and building electronics, simple, 
affordable and fun. pi-topOS is here to guide you through 
the world of making! 


The OCR* endorsed pi-topOS (Operating system) platform 
comes pre-installed on the SD card shipped with every 
unit. pi-topOS software suite lets you - browse the web, - 
check emails, - create and edit Microsoft Office 
compatible files. Gain access to dozens of hands-on 
Learning lesson plans with pi-topCODER and have fun 
Learning to code with CEEDuniverse! 


Creete 


pi-topCODER 


CEEDuniverse 


pi-topCODER has a fully 
integrated coding environment 
Letting you program hardware, 
code in Python and learn Lots 
of STEAM skills! Our integrated 
test framework gives you the 
ability to assess your own 
understanding as you Learn. 


CEEDuniverse 


Learn programming concepts 


through our minigames, 


for example, learn problem 
decomposition by solving 
visual programming puzzles. 


= 2 @ 
it mt mt it 
Tt Tt Tt Tt R N # Tt Tt Tt 


ANDROID 


ON RASPBERRY PI 


How to get Google’s Android operating system working on your Pi! 


he Raspberry Pi has been 
used in many different 
ways over the years by 
many different people. Installing 
Android on Raspberry Pi, while a 
pretty popular idea, has never been 
super-easy, though. Solutions have 
existed in the past, but have never 
worked like true Android. 

Recently that’s all changed. 
While limitations stopping Android 
working properly on Raspberry 
: = Pi were lifted some time ago, it’s 
Wt h ant i : 28.) (7 +s taken until now for a build of full 


# TIATIG CAPER 


ae 8 
> 


a= 9 a2 hat Android to be created by budding 
{PP tte hackers to run on the Pi. We look 


at emteria.OS, the first proper 
Android release for Raspberry Pi. 

That’s not the only way to use 
Android on Raspberry Pi either, as 
Google has released an IoT-focused 
version called Android Things. 

Not sure which one to use? We’1l 
show you how to use both, and 
why you might want to, over the 
following pages... 
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CHOOSE 
YOUR 


Things or emteria.0S? 
You decide! 


Emteria.OS is a full build of Android available for Raspberry 
Pi. While you can get it for free and use it as an individual, 
it's aimed more towards industry. Embedded Android 
devices are big business, and marrying the mobile OS 

with the Pi opens up a whole new world of Android in both 
maker projects and consumer products. 
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android 


things 


@ 


This stripped-down, official release of Android is perfect 
for loT applications. It’s a lot more simplistic than full 
Android, and you need to program it from a separate 
computer. However, we've seen people do some amazing 
things with it - see some of them on page 26. 
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& INSTALL 


EMTERIA.OS 


Installing Android onto your Raspberry Pi made easy 


Contacts 


MagPi July 2018 


t’s been a long time 
coming, but finally there’s 
a proper way to install 

full Android on your Raspberry Pi 
thanks to emteria.OS. Based on 
RTAndroid, this stable version is a 
bit more aimed towards business; 
however, more personal-use 
versions will be coming soon. 
Here’s how to set it up. 


01. Desktop 

The main desktop will be familiar 
to those that have used Android 
as a tablet device. 


02. Mouse control 

While emteria.OS does work 
with a number of Raspberry Pi 
touchscreens, you can still use it 
with a mouse and keyboard. 


03. F-Droid 

F-Droid is an app store alternative 
available on emteria.OS, allowing 
you to install a number of free apps. 


04, App drawer 

All your other apps live in here 
and, like on other Android devices, 
you can move them onto your 
main display. 
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STEP 01 


You’ll need to first register an account on 

— look for the Register option on the top right of the 
home page. Fill out the relevant details, confirm your 
email address, and then make sure you’ re logged into 
your account on the emteria.OS website. 


Finish Registration 


Enter Your Details for Instant Access 


Account Settings 


STEP 03 


All you need to do now is open the installer, enter 
your emteria.OS username and password, and 
select the Raspberry Pi 3 as your device of choice 
for installing. Next, you’ll need to select your 
microSD card as the installation location and 
then just wait — the installer will download the 
image and then burn it to your microSD card. 
Now you’re ready! 


CONTINUE 


raspberrypi.org/magpi 


EMTERIA 


your@email.com 


STEP 02 


From your emteria.com account you can download 
the installer for your system. This will burn the 
image for emteria.OS onto a microSD card to be 
used in a Raspberry Pi. On Windows you’ll have to 
install the installer using the setup wizard, while on 
macOS you’ll have to drag it into the Applications 
folder and run it using superuser in the Terminal. 


Emterig.OS prices 


@® Device Activation 


During the 
initial setup 

of emteria.OS, 
you'll be asked 
to activate your 


device with a 

licence - clicking Next allows you to continue on 
with emteria.OS and use it for free. There are some 
limitations, however: it only stays on for eight hours 
at a time, and has a watermark in the corner. Perfect 
for testing it out with a few projects, though! 


There are full licences for purchase on emteria.com, 
including a cheaper ‘personal’ option and one suited 
for business that includes bulk-buy discounts. 


Pricing 


Available Licensing Plans 


Evaluation Personal 
rnet only €45 
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INSTALLING 


APPS 


Here are some extra ways to install 


software onto your emteria.0OS-powered Pi 


20 


NewPipe 
Play YouTube videos on 
your device with this small, 
lightweight app that doesn't 
require the original YouTube 
app to work. 


Terminal Emulator 
As emteria.OS is a bit more 
hackable than stock Android, 


more advanced commands. 


Face Slim 
Missing out on some social 
media time? Face Slim allows 


the standard app. 
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you'll be able to make good use 
of this terminal emulator to run 


you to use Facebook much like 


INSTALLING F-DROID APPS 
Start F-Droid 


Find F-Droid on your home screen on in the apps 
menu and start it up. It won’t launch straight away 
as it will first need to update all its repositories — 
something you’ll be familiar with from installing 
software on Raspbian using apt-get. This might 
also take a while so please be patient. 


3:15 PM * Thu, Jan 11 


Updating repositories 


Find an app 


F-Droid works very similarly to the usual Play Store 
on normal Android devices. There are categories 
you can look for apps in, and you can also search 
for something you like. Some of your favourite apps 
on Android may even be available. 


€ Yalp 


eB EnigmAndroid Simulat 


Yalp Store Download apks from Google Play Store 


Install! 


Select the app you want, then hit the install button. 
It’s as easy as that — F-Droid even includes some 
info on the apps as well. F-Droid also lets you 

keep the apps up-to-date, although it’s a bit more 
manual than the Play Store equivalent. 


Yalp Store 


by Sergey Yeriomin 


Store as apk files. it can search fo stalled apps and lets you search 
to your default download folder Other features incl owsing categories, viewing and leaving 
ps for updates, filtering by being free/paid and ox Not containing 


Store lets you downloed apps directly fromm Google Play Store s 
ip saves downloeded apks 


a wip saves d 
b f < 


To supplement the features related to Google Ptay, Yalp Store has ordinary package manager features: listing, running, installing and 


A This app has features you may not like. 


raspberrypi.org/magpi 


feature 


SIDELOADING 


STEP 01 STEP 03 


Once the APK file has been downloaded, 
open it from the Downloads menu. You may 
need to enable installing from unknown 
sources if you’ve turned that option off in 
the emteria.OS settings — otherwise it will 
go about installing the Netflix APK for you. 
It will appear in your app menu as usual, 
although you’ll need to perform manual 
updates every now and then! 


Android apps work by 
downloading a specific file 

which is then used to install the 
software onto the device. These 
files are called APKs, as that’s the 
file name extension (.apk). If you 
have the APK file, you can install 
it on Android without having to 
go through a separate store. 


STEP 02 


NETFLIX 


F-Droid specialises in free and open-source 
Android apps, so you may not find everything you Popular on Netflix 
want on there, such as Netflix. As Netflix is more 
concerned about you being able to watch the shows 
you’ re already paying for, the APK for the app is 
available from its website. Open the browser in 
emteria.OS and head to 


tie 
. ABSWER 


| can't download the Netflix app on my i 


Successfully Installed Netflix 


Using the Google Play Store 


With custom versions of Android, there are some restrictions. One of 
the big ones is that the Google Play Store and some of the proprietary 
Google apps are not allowed to be included with software. However, 
this doesn't stop you from installing APKs using sideloading. 
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feature 


INSTALL 


You too can do loT with 
Android Things and G Raspberry P| screen or app menu or anything like that, but you 


androldthings 


STEP 01 


Head to the Android Things console 

( ) and sign in with your Google 
account. Click on the menu in the top left to find 
the Tools section, where the Android Things Setup 
Utility lives. You’1l need to download this and then 
unzip the files within — there’s no extra installation 
for the setup utility. 


July 2018 


simpler way of putting Android on the 
Raspberry Pi, Android Things is optimised 
more for IoT. You won’t be getting your home 


can program it to be a bit more customisable than 
stock Android. 


STEP 02 


On Windows, you’ll need to right-click on the 
Setup Utility EXE (which has ‘windows’ in the file 
name) and run it as Administrator. On macOS and 
Linux, you’ll need to run it from a terminal with 
something like: 


sudo ~/Downloads/android-things-setup-utility/ 
android-things-setup-utility- linux 


...but making sure to point towards the correct file 
in the correct folder. 


| android-things-setup-utility-linux 
| android-things-setup-utility-macos 

(i android-things-setup-utility--~*------—-- 
) README.md Sees 


@ Runas Wo 
Troubleshoot compatibility 


Run with graphics processor 
Pin to Start 
(uf Edit with Notepad++ 
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Flash the SD card 


A command prompt window will appear with two 
options — you’ll want to choose ‘Install Android 
Things and optionally set up WiFi’ by typing 1 
and then ENTER. Next, choose Raspberry Pi 3, 
and then get the default image when prompted. 
Make sure you have a microSD card ready to 
flash for when it asks for it to be inserted after 
the download. Follow along with the rest of 

the prompts to select the card and wait for 

it to be flashed. 


Android Things Setup Utility (version 1.0.21) 


RUN ANDROID ON RASPBERRY PI 


what hardware are you using? 
Raspberry Pi 3 
NXP Pico i.MX7D 

u 


fou chose Raspberry Pi 3. 


Setting up required tools... 

etching additional configuration... 
lownloading platform tools... 
4.74 MB/4.74 MB 
Unzipping platform tools... 

inished setting up required tools. 


it to use the default image or a custom image? 

t image: Used for development purposes. No access to the Android 
Things Console features such as metrics, crash reports, and OTA updates. 
- Custom image: Upload your j 


with all Android 


custom image for full device development and 


anagement Things Console features. 
1 
Jownloading Android Things image... 
331 MB/331 MB 

Inzipping image... 


Downloading Etcher-cli, 


19.8 MB/19.8 MB 
Inzipping Etcher-cli 


a tool to flash your SO card... 


Plug the SD card into your computer. ess [Enter] when ready 


his tool will help you install Android Things on your board and set up Wi-Fi. 


Nhat do you want to do? 


- Install Android Things and optionally set up Wi-Fi 


- Set up Wi-Fi on an existing Android Things device 


Jhat hardware are you using? 
- Raspberry Pi 3 
- NXP Pico i.MX7D 


ou chose Raspberry Pi 3. 


Setting up required tools... 

etching additional configuration... 
Downloading platform tools... 

.74 MB/4.74 MB 

nzipping platform tools... 

inished setting up required tools. 


Please plug your Raspberry Pi to your router with an Ethernet cable, then press [Enter]. 


Setting up wireless internet 


Once flashing is done, you can take the microSD 
card out and put it into your Raspberry Pi. At the 
very least, you need to have the microSD card 
inserted and have access to a power supply. If you 
still have the setup utility open, you can then set 
up the wireless internet on your device by also 
plugging an Ethernet cable into the Pi. If you’ve 
exited the setup utility, just start it up again and 
choose the second option. 


Alternate wireless setup 


If you don’t have access to wired internet, you 

can always plug the Pi into a monitor and use the 
included utilities to connect to your WiFi for further 
configuration. You can also do it via adb (Android 
Debug Bridge) if you want to get into the nitty- 
gritty of wireless setup — find out more info on that 
here: magpi.cc/PHWvQR. 
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Unfortunately, Android Things does not support 
the Pi Zero — it requires a bit more power than the 
board can currently provide, so you'll need at least 
a Raspberry Pi 2 to run Android Things on, 

but preferably a Pi 3. 


Dye) Sed 
ee 
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Learning how to use 

the loT-focused Android 

P making an Android app. It can make use of 
Google services and is programmed in Java. 


This means it’s a bit more advanced than using 
Python in Raspbian - even something as simple as 
lighting an LED takes a lot more time than using the 
Python GPIO Zero library to do so. 

Software is built into Android Studio and then 
uploaded to your Raspberry Pi - this way you can 
quickly prototype and test your code before updating it 
and testing again. It also means you can have multiple 
projects on the go that use the same Pi - you just need 
to switch between them. 


rogramming Android Things is much like 


Grab the Android 
Studio software from 
magpi.cc /DqPMKe. 
Install it and then 
open it, and go to 
‘Start a new Android 
Studio Project’. Call 

it whatever you wish 
and then select 
Android Things as the 
form factor, with the 
latest SDK. You can then access your project through here, including 


a Target Android Devices 


Select the form factors and minimum SDK 
Some deveces require addiaicnal SDKs. Low AP! levels target more Gevicet, Dut efter fi 


any previous code you've created or edited. 
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GREAT 
STARTER 
PROJECTS 


LED blinker 6} =magpi.cc/cKFOQw 


This beginner’s tutorial shows you how to blink an 
LED using Android Things. While it’s much more 
complex than using GPIO Zero, you’ll be using Android 
Things for more than just controlling electronics via 
the GPIO. It’s well explained and gives you a nice basic 
tour of the Android Studio work area. 


@} magpi.cc/BraebS 
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cries F: 


Hackster.io 

Android Things projects 
Many people use Hackster.io to post 
and document their builds, and there 
are plenty of projects to find on here 
for both beginners and advanced 
users alike. There's even a special 
Android Things tag for those kinds of 
projects, and you can further filter it by 
Raspberry Pi projects. 


63 magpi.cc/gpmLrZ 


LED with a button 6} magpi.cc/FKSVLp 


Using Bluetooth 


RUN ANDROID ON RASPBERRY PI 


lw 
A - 
% 
. 


- a 


a irs 


A follow-up tutorial to the LED blinker, this adds 
input command code to the already present output 
code for the LED. From here you can begin to see how 
the code reacts to events, and you can start building 
Slightly more complex circuits as well. 


Jumping ahead, this tutorial teaches you how to make 
use of Bluetooth communication on your Raspberry 

Pi with Android Things, which is slightly more robust 
than the available Python libraries you might use in 
Raspbian. From here you can start truly developing an 
interesting project for yourself. 


% Bluetooth’ 
THINGS RESOURCES 


Android Things 
documentation 

The basic information for 
Android Things is a good place 

to look for all your Android Things 
needs - it also covers other 
devices, which may be of use to 
you if you're planning to branch 
out with what your Things app 


Raspberry Pi 

Forums 

Need some help with your 

Pi project? The Raspberry Pi 
forums are the best place to 
go to ask questions about 
what you're doing - you may 
even be lucky enough to find 
an existing thread that solves 
your specific issue! 


69 raspberrypi.org/forums 


69 Magpi.cc/QDDIXY 


= 
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Not sure where to get started with Android Things? 
Here are some cool projects to help inspire you! 
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Sentinel 6} magpi.cc/YsxVco 
Looking for a home security robot? Well, you might 
want to keep looking (and wait a few decades), but you 
can build this semi-autonomous Pi robot that’s able to 
provide some level of security. 

The Sentinel follows the maker’s dog, as he 
wanted to see how it’s getting on while he’s not 
home. Sentinel was cheaper than IP cameras. Facial 
recognition has also been added, as well as text-to- 
speech so the robot can talk to you. 


BrailleBox 


69 magpi.cc/dxMNje 


An ingenious project to help blind people stay informed, 
the BrailleBox at its simplest loads news stories from 
the internet and then translates them into Braille for the 
user to be able to read it. 

The project has evolved beyond this initial concept, 
though, allowing the user to slow down or speed up 
news reading, and to press a button for the device to load 
the latest news story from News API (newsapi.org). 
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This recent project took the internet by storm, using 
an off-the-shelf IKEA lamp and turning it into a 
laser-projected smart interface. It’s all high-tech and 
futuristic and runs simply on a Raspberry Pi 3 with 
Android Things. 

As well as smart interfaces, it can project what 
the makers call ‘ambient data’ onto a surface: say, 
a scrolling weather forecast onto a wall, or a ‘now 
playing’ info screen on the edge of a thick side-table. 


Another project designed for people with vision 
impairments, these glasses look ahead of the wearer and 
tell them what’s in front of them using Google services 
such as TensorFlow. 

This could be modified to be used a bit like a futuristic, 
high-tech smart display, showing you what’s ahead, or 
even to help create advanced automation in a robot. 
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While analogue watches may be a great fashion 
statement, they’re not quite as convenient as digital 
watches. Or this word clock, which writes out the time 
using letters cut out of a board. 

You can control the colours of the LEDs through 
a dedicated companion app, or by connecting it to 
a Google Home assistant. Ideal for lowering the 
brightness while you watch a film or to set the 
nerdiest mood lighting imaginable. 
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PI ZERO W 
STARTER KIT 
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Pi Zero W 


eeeeeseseoocceseeeeen 


Pi Zero W case 
with three covers 


USB and HDMI 
converter cables 
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Camera Module 
connector 


> Use Android Apps 


MAKE YOUR OWN (== ESSSsnene 


Build Touchscreen Devices Control Electro 


IN PRINT 


MAGIC: THE 
GATHERING 


9 Available on the 


« App Store 


GET IT ON 


> Google Play 
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ROBERT ZAKON 
* Robert Zakon is a technology v 
rt 2 Hidden inside the PVC tube, entrepreneur and former White House te x 
; mp a Speaker pHAT is used to Presidential Innovation Fellow who lives al 
. speak the item description in the mountains of New Hampshire —_ 


4 (USA) with his wife and their two 
wondrous sons. 


One push-button is used to take a 
zakon.org 


photo of an object; the other turns 
the Pi Zero W on and off 


A Pi Camera Module 
at the end of the wand 
takes a photo of the 
item to be identified 


Point this magic wand at an item and it’ll speak its name. 
Phil King lifts the curtain to see how it’s done 


nspired by a blind cousin cognitive computing services,” 
Build details who would ‘look’ around explains Robert. “They were a bit 
are at his environment by way sceptical at first, but warmed up to 
chp reg of touch, Robert Zakon has built it and thought the end result was 
a Seeing Wand that can speak the pretty awesome (their words). My 

The wand is : : : 
programmed name of whatever it’s pointed at. eldest helped with assembly, and 
using Python Housed in a makeshift PVC tube, both aided in testing.” 
Code is on a Pi Zero is connected to a Camera 
GitHub: Module that takes a photo when a First taste of Pi 
anal push-button is pressed. The image Robert’s debut Raspberry Pi 

is sent to Microsoft’s Cognitive project, it came together over the 
nett Services Computer Vision API to course of a few weekends. 
used for ID get a description, which is then Asked why he chose Microsoft 
ican spoken — using the open-source Cognitive Services over other 
identifications espeawspeecch synthesizer = image-recognition APIs, Robert 
can be amusing through a Speaker pHAT. responds: “Microsoft did a nice 

“1 was looking for a way to teach job with the API and it was fairly 

my kids about innovation through straightforward to integrate with. 

integration and had been wanting There was no particular reason for 

to test out both the Piandemerging choosing it other than it appeared 


Point the wand at an item, press the 
button, and its description is spoken 
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SEEING WAND ‘Projects 


MAKE A MAGIC WAND 


vee 
eeeeeeeer’ fe 
Te 


Wiring the electronics PVC housing Two buttons 

Components include a Pi Zero W, The electronics are crammed into a PVC The breadboard holds two push-buttons: 
Camera Module, and Speaker tube. The camera fits into a closet-rod- one to take a photo of the item you want 
pHAT. Wiring is currently via a mini supporting end cap and is held in place by to identify, and the other - wired to the 
breadboard. The device is powered rigid insulation, with its lens up against the GPIO 03 and GND pins - to turn the Pi 

by a 2200 mAh power cube. cap’s screw hole. Zero W on and off. 


to be robust enough and free to use As per its original inspiration, the text recognition and possibly 
for our project.” however, the Seeing Wand could language translation services so 
The results surprised him in be of serious use to partially signs and printed material could 
terms of accuracy and level of sighted people. “Although there be read, and the face recognition 
detail: “People, pets, and large are smartphone apps that do the service so people could be 
objects seem to be the sweet spot.” same thing, this could be a less identified. Also, as the cognitive 


services are not yet perfect, it 
would be interesting to ‘poll’ 


Even when the wand gets it multiple services and determine 
WIONQ, the results can be amusing which identification is best through 


our own cognitive meta-service.” 


Even when the wand gets it expensive and more human- 
wrong, the results canbe amusing. friendly device.” 
“My kids had a lot of fun whenever 
something was misidentified, such Fine-tuning 
as pointing atatoyrobotonatable Robert admits that the prototype 
and having it identified as ‘asmall wand isa little rough around the 
child onachair’. Anotherexample edges. “We have talked about 


was pointing at our garage witha making improvements both to the 
sloping roof and being informed hardware and software. On the 
there was ‘a skateboarder coming hardware side, we would solder 


down a hill’ - still not sure what it all wires and buttons, and use a 
thought the skateboarder was. My smaller battery in order to make 
favourite, though, had to be when it truly palm-sized and thinner 


we pointed it at clouds and heard so it could fit as the holding end 

is Aadlifica © f ne lal E p A Pi Camera Module is used to take photos of items, 
What sounded like “Superman of a white (blind) cane. For the | while speech is output through a Speaker pHAT 
flying across a blue sky’.” software, we’d like to integrate = 


raspberrypi.org/magpi July 2018 MagPi | 31 


GHOST CAEge 


With this game of chess by Tim Ness, Alex Angelov, and Alex Smith, 
the pieces appear to move by themselves. David Crookes checks it out 


» Each chess 


> Forty 3mm 
>» The arm's 


» It's controlled 


» Chess engine 
Stockfish is 
open-source 
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A mechanical arm below the board 
moves the pieces. By shifting them to 
the corner of a square and then only 
moving along the square edges, it 
avoids collisions with other pieces 


in LO) PSOE ISOC. 

chess-playing computer 

called Deep Blue sent 
shock waves around the globe by 
beating world champion Garry 
Kasparov in the first of their six 
games. But the IBM machine did 
so without moving any physical 
pieces itself - a human noted the 
computer’s move and performed it 
manually on the board. Had Ghost 
Chess been around back then, 
however, such intervention would 
have been redundant. 

Designed by final-year MEng 

students Tim Ness, Alex Angelov, 
and Alex Smith from the University 


piece is 3D 
printed 


button 
magnets 
are used 


electromagnet 
has a 4.5G 
pull force 


using GPIO on 
the Pi 
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of Glasgow, Ghost Chess makes 
use of a robotic arm connected 
to a Raspberry Pi running the 
world champion chess program, 
Stockfish (stockfishchess.org). 
It focuses attention on a physical 
board, using motors and an 
electromagnet to pick up, move, 
and place 3D-printed chess pieces 
within the squares depending on 
the moves dictated by both human 
and computer. 

As such, it’s a mini-marvel - 
a prime example of a real-time 
embedded system. “We wanted 
to create something that was fun, 
memorable, and slightly more 


Each chess piece has a button 
magnet on the bottom. The 
magnetic field needed to be strong 
enough to hold the piece while not 
attracting surrounding ones 


A Raspberry Pi 3 runs the Stockfish 
chess engine. This allows the 
computer to decide on its moves, 
with software also controlling the 
robotic arm under the board 


challenging — an ‘automatic’ 3D 
chess game from scratch,” says 
Tim. What’s more, they wanted 

to make it as unobtrusive as 
possible. “We kept the robotics 
underneath the board because it 
Was an easier way of designing the 
system,” Tim adds. “It keeps all 
of the electronics and the moving 
mechanism out of the way.” 


Multilayered project 
Indeed, the project is broken down 
into five layers: the chess pieces, 
the board, a matrix of sensors, 

the mechanical arm, and, at the 
bottom, the Raspberry Pi 3. Of 
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those, the arm was the trickiest 
part to develop. “Creating a design 
without having access to expensive 
ball races/bearings was a real 
challenge,” Tim recalls. 

T-slot bars bolted to a plywood 
base act as runners for two shuttles 
and these are hooked up to timing 
belts mounted through a couple 
of pulleys to a stepper motor, 
allowing the arm to move left, 
right, up, and down. Meanwhile, 

a matrix of 64 latching Hall effect 
sensors (one for each square and 


devices,” says Tim. “We used 
Raspbian as the platform for 
development, which allowed us 

to create a GUI fairly easily and 
helped a lot with the development 
and debugging process.” 


Moving pieces 

Once a move is decided, the 
software instructs the arm to make 
its way to a piece. It then turns on 
the electromagnet positioned on 
top of the arm, which attracts a 
button magnet fitted to the bottom 


There was a lot of difficulty 


integrating all of the different 
parts of the system 


capable of varying the output 

voltage in response to a magnetic 
field) lets the setup detect which 
Spaces on the board are occupied. 

From that point on, it’s up to the 
software running on the Pi to work 
its magic. For this, the students 
coded their own program to work 
with the Stockfish API. It not 
only allows humans to enter their 
moves through a graphical user 
interface or via a command line, 
it also empowers the computer to 
decide where it needs to go. 

“The RPi is a versatile platform 
for development which provides 
competitive input and output 
capabilities, compared to other 
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of each piece. At this stage, the 
robotic arm can start to perform 
the move. Seeing physical pieces 
move across the board is far more 
satisfying than simply playing 

on acomputer. 

“There was a lot of difficulty 
integrating all of the different 
parts of the system and calibrating 
them in order to work as 
expected,” says Tim. “We think 
the trickiest part was trying to 
work on a tight budget and design 
solutions for different parts of 
the system, without breaking the 
bank, and we hope the idea will be 
passed on and upgraded during the 
coming years.” 


Sensors are 


positioned below 
each of the 64 
squares. They detect 
which squares are 
occupied and feed 
the information back 
to the software 


GHOST CHESS 


Projects 


TIME TO 


MAKE A MOVE 


GhostChess 


Select difficulty: 


® Easy © Medium © Hard 
Enter Move: 
e1e2 Confirm 


e2e4 e7e6 d1f3 b8c6 
b2b4 c6b4 F1c4 b4c2 
ele2 c2d4 
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Projects 


> The build 
and code 
took Michael 
ten hours 


» It uses LEGO 
bricks — and 
plastic tyres 


» The various 


components, 


Pi included, 
cost $115 


> 20-25 cards 
can be 
recorded 
per minute 


>» There are 


20000 official 


MTG cards 


SCANNER/ORGANISER 


For his next trick, Michael Portera created a system out of 
LEGO to recognise, organise, and value his vast collection of 
Magic: The Gathering trading cards. David Crookes investigates 


hen Michael Portera 

came across a few boxes 

packed with trading 
cards — “everything from football, 
baseball, and basketball to Magic: 
The Gathering (MTG)” — one of 
his first thoughts was how much 
the collection might be worth. As 
someone who had dabbled with 
MTG by buying booster packs and 
playing the occasional game with 
friends, he knew there was a large 


secondary market and that he had 
cards worth investigating. 

“But looking up the cards 
manually would have taken a 
while, even using online scanners 
or apps,” he muses. “So I wanted 
to develop an automated process 
using a card feeder and a scanner for 
image processing.” 

Motivated by the potential time 
saved, he quickly got to work. The 
spell-binding result was a scanner 


made of LEGO, servo motors, a 
camera, and a Raspberry Pi 3. 


Shuffling cards 

Right from the start, Michael 
envisaged a simple system that 
would spin and push preloaded 
cards forward to be photographed 
and uploaded for digital storage and 
processing. The idea was to make 
light work of organising and valuing 
even the largest of collections. 


The LEGO platform took a couple 
of hours to build. It stores the 
cards and readies them for 
individual scanning 


The project is designed to work 
with Magic: The Gathering trading 
cards. The fantasy game has 
echoes of Dungeons & Dragons 


This unit contains the Camera 
Module and Pi 3. The short length 
of the camera's ribbon cable 
caused problems 
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Michael used the free 

tier of Amazon's object 
storage service S3 
(aws.amazon.com/s3), 
which allows 2000 images 
to be uploaded each month 


Building it, however, was largely a 
process of trial and error. 

“T had a cheap card shuffler 
lying around,” recalls Michael. 
“After taking it apart, I found the 
simple cog system powered by a 
DC motor that moves the hammer 
and pushes one card forward into a 
slot, creating a new Stack of cards. 
This would be the inspiration for 
the servo and wheels needed to 
accomplish the automation.” 


Box of bricks 

Michael turned to LEGO for 

the main structure due to its 
versatility. It allowed him to easily 


another script to send the images 
to Amazon’s cloud computing web 
service S3, for storage and to tackle 
image processing. 

“T originally tried Tesseract 
and OpenCV for optical character 
recognition, but I spent a lot 
of time trying to get so many 
variables perfect and I couldn’t get 
consistency,” he explains. To fix 
this, he turned to Amazon’s deep 
learning-based image analyser, 
Rekognition (magpi.cc/sfLJLE), 
which extracts text and indexes a 
collection. “It works well. I did not 
have to worry about getting the 
angle just right, making sure the 


The 1dea was to make light 
work of organising and valuing 
even the largest of collections 


build, modify, and tear down his 
project. He placed servos in the 
back of the build and had them 
Spin continuously. Carefully 
positioned LEGO tyres then move 
forward in a cog-like setup to get 
the cards into position. 

Once the device was built and 
he was happy, Michael could then 
start coding, which he says was 
the easiest part of the build. He 
used Python 2.7 to program a 
Script to power both the servos 
and take a picture via a Raspberry 
Pi Camera Module. He then wrote 
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lighting was perfect, or performing 
any machine learning — it worked 
despite all of those factors.” 

Apart from issues deciphering 
some fonts, it performed well: 619 
of the 920 cards scanned perfectly 
and he was able to feed the data 
through TCGPlayer.com’s price 
data API to determine the value of 
each card and, therefore, his MTG 
collection. “I had about S275 worth 
of commons, uncommons, and 
rares,” he says, pleased as punch. 
“And through trial and error, I also 
learned a lot along the way.” 
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Projects 


a 
— 


There's even a mini TV that 
you can turn on and off 


> The doll'’s 


house took 
ten weeks to 
design and 
prototype 


>» A Pi 3 reads 


information 
from a motion 
sensor 


> ‘MYHouse is 


short for ‘Maks 
and Yi Fan's 
house’ 


» All the code 


can be found at 
magpi.cc/ 
GnJNjN 


>» Machine 
learning is used 
to ‘train’ the 
gestures 
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A PlayStation Move controller 
is used as the magic wand! 


PROJECT 


The speed of the 
ceiling fan is set by two 
finger-rotating gestures 


This smart doll’s house features gesture recognition. 
Nicola King takes a look inside... 


hen a master’s degree 
course at the University of 
Washington required the 
use of sensors and machine learning 
in the same project, two students 
— Maks Surguy and Yi Fan Yin - 
conceived the idea of an interactive 
doll’s house. Inside this cool crib, 
various features — including lighting 
and shutters — can all be turned 
on and off by the simple wave 
of a ‘wand’ (a PlayStation Move 
controller), with the help of some 
clever coding and a Raspberry Pi 3. 
You can see a demonstration video 
at youtu.be/6EiITWZfPm3k. 
“T thought a smart doll’s 
house would be a great tool to 


demonstrate technical innovations 
to people in an approachable way,” 
says Maks, who worked with Yi Fan 
over a ten-week period, designing 
and constructing the clever little 
doll’s domicile. 

After consulting Maks’s architect 
wife about the physical structure, 
the pair drew the plans in 3D 
modelling software, then fitted 
together cardboard pieces for a 
prototype. Once happy with the 
design, they laser-cut the pieces 
out of plywood, made use of 
snap-fit to join them, then painted 
them in different colours. 

According to Maks, building a 
doll’s house is akin to building 


a real house. “Lots of decisions 
needed to be made about 
dimensions, colours, structure, 
function, and interactions between 
all elements of the dollhouse. We 
ended up simplifying a lot of the 
elements through iterative process 
after realising that what we 
envisioned is actually a lot harder 
than it seems. Thankfully we had 
24/7 access to a makerspace here 
in school and were able to reach 
decisions through prototyping 
every aspect of the construction.” 


Grand gestures 
A key characteristic of this smart 
doll’s house is its ability to 
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recognise gestures and respond 
accordingly. Having done a great 
deal of research into gesture 
recognition, “trial and error went 
into choosing what gestures 
perform best across individuals 
while remaining intuitive to most 
people,” says Maks. “We reada 
lot of research papers on gesture 
recognition and then came up with 
our own gestures that worked with 
Over 90 percent accuracy.” 

In total, seven gestures — 
pre-trained using machine 
learning — are stored in the 
system, and the Raspberry Pi 
reads the information from 


The machine learning aspect of 
the project also presented certain 
challenges, as Maks recalls: “We 
ran into trouble selecting the 
most intuitive gestures and had 
to do quite a bit of trial and error 
to refine the experience. It takes 
about 20 samples per gesture 
to train the neural network, 
which is doable in a matter 
of a few minutes.” 


Possibilities of Pi 
Maks was keen to use a 
Raspberry Pi in this project as 
he is enthusiastic about the 
possibilities it presents: “I am 


MY House overview 


Intuitive Gestures 


that teaches people of all ages 


Shutters 


Raspberry Pi 


Machine Learning 
+ 


Actuation 


A Raspberry 


Pi 3 reads the 


the PlayStation Move and then interested in pushing the Pi to its how to use the Raspberry Pi pestiposand 
determines if the gesture is limits.” He also has plans for the and Processing together, taking controls all the 
similar to one of the storedones. future, currently working with advantage of all connectivity and So cscrucene sa 


interactivity available on the Pi.” 
If the idea of an interactive doll’s 
house appeals, the open-source 
nature of the code that Maks has 
created means that this is a build 
that anyone can attempt, as long 
as they possess some coding skills 


Iam interested 1n pushing 
the Pi to its limits 


As Maks explains, if the gesture the Processing Foundation as a 
is recognised, “various functional — part of Google Summer of Code and the necessary components. 
items in the dollhouse can be initiative to reduce barriers in “We haven’t released the building 
activated or deactivated using using the Processing language on plans for the dollhouse yet but if 
these pre-trained gestures: TV, the Raspberry Pi. “My plan is to somebody’s interested, I can share 
lights, fan, and shutters.” create a comprehensive resource those as well,” says Maks. 


>STEP-02 

NeoPixel letters 

The laser-cut M and Y letters are each 
fitted with a strip of NeoPixel LEDs. 
Servos are used to rotate the ceiling 
fan and open the shutters. 


>STEP-03 

Gesture training 

Maks and Yi Fan researched the most 
intuitive gestures to use. Each gesture 
was trained using a neural network, which 
involved taking around 20 samples. 


>STEP-01 3 ’ 
Plywood structure nt a ae 4 | | { Ga TAyAz [Gx [GY Fan 


After constructing a cardboard [Az | AY[A2 [Gx [GY Fan 
prototype, the doll’s house was [42 | vl [Az |Gx LG . LEp 
built from laser-cut plywood ee 

ss a TATASTEXTGT IGT | is Getee 


pieces which snap together. 
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> It took three 
months to 
design and 
build the robot 


> Both Python 
and Processing 
are used 


>» View a video 
of it in action 
at magpi.cc/ 
JXhmpT 


>» See Cadin's 
latest comics 
on Instagram 
@cadinb 


>» He'd like to 
make a themed 
comic version 
of the robot 
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A tiny robot designed to make you 
smile? Nicola King sees the funny 
side of robotics 


Due to a lack of 
space inside the 
robot body, Cadin 
used a right-angled 
USB plug for the 


printer connection 


adin Batrack enjoys 
creating his own small 
comics, and likes to 
publish a new one every day on 
his Instagram account (@cadinb). 
Having decided to create a program 
to randomly generate high- 
resolution comics, he was inspired 
to take things a step further. 
“Shortly after starting that 
project, I was invited to participate 
in a local comic show,” Cadin 
tells us. “I wanted a way to show off 
the random comic software at my 
booth, to let people generate and 
print a custom comic to take with 
them. The obvious solution was 
to build a little yellow robot that 
vomits comics out of his mouth.” 


Out of the mouths 

of robots 

Having created the random comic 
software using the Processing 
language, Cadin chose to use a 
Raspberry Pi3 to run this anda 
Python script. The latter controls the 
robot’s LEDs, handles push-button 
input, and sends the comic images 
to a mini thermal printer connected 
to the Pi via USB. Cadin made a 
laser-cut plywood casing to hold all 
of the components, and the amusing 
little ‘Vomit Comic Robot’ was born. 


The case is 
constructed from 
laser-cut plywood 


Press this button to 
generate a comic 


A thermal receipt 
printer produces 
the comic 
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When the robot’s button is 
pressed, the Python script sends a 
message to the Processing sketch. 
“The sketch generates a random 
comic layout, and chooses some 
of my drawings to populate the 
frames,” explains Cadin. “It 
chooses at random from about 100 
drawings. Each image has some 
associated data that informs how it 


I would like to make a version that 
lets you choose a theme for your 
comic, like Tood’ or ‘animals 


should be composed within a comic 
frame. The final composite image 
is saved to the Pi’s SD card.” 

The Python script then loads the 
image and sends it to the printer. 
“With each comic | also print the 
date, the comic number, and the 
name of the event.” 


The robot that gags... 
gags, geddit? 

Cadin hopes to tweak the robot in 
the future: “I would like to make 

a version that lets you choose a 
theme for your comic, like ‘food’ 

or ‘animals’ or ‘nature’. I imagine 
a big dial on the robot that lets you 
select the theme and then you get a 
comic with images from that theme 
when you press the button.” 


According to Cadin, the project 
could easily be replicated using 
his comic-generating code 
(magpi.cc/tOYOcL), and makers 
can add their own drawings. “If 
you wanted to print something 
else (not random comics) it 
would be even easier, because you 
could leave out the Processing 
sketch entirely.” 


Cadin has received a lot of 
positive feedback on his humorous 
hack, but says he isn’t sure that 
people really understand what 
is happening inside the robot: 

“Tt would be nice if they could 
somehow see the comics being 
generated to understand that 
it’s happening dynamically, 
and not just printing outa 
pre-made comic.” 

Some people have suggested 
adding more narrative to the 
comics, but Cadin isn’t sure: “I like 
that they come out as nonsense... 
He’s not a very smart robot!” 

Vomit Comic Robot may 
not be smart, but this is one 
quipster guaranteed never to get 
stage-fright. 


is 


Each printout 
features details 
including the event 
name and date 
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VOMITCOMic ROBOT Projects 


MAKING A VOMIT 


Creating comics 

Cadin first created the random comic generation 
software using the Processing language. You can find 
his code on GitHub at magpi.cc/tOYOcL. 


wanes 
7). The Atte le 


Connecting the components 

All the software runs on a Raspberry Pi 3. Its GPIO 
pins are connected to a push-button, status LEDs, 
and the thermal printer. 


ee 
<= 
—$—_[—— —————— 


The final build 

Laser-cut plywood was used to construct the robot's 
body. Cadin admits he made it slightly too small, so 
had to make some adjustments inside. 
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“It’s a really fun educational computer kit 
that should really impress those who love 


Minecraft and building stuff” The yzye 
Magi 


Want to learn how to bring Piper to your school? 


buildpiper.com/EDU 


THE PIPER EXPERIENCE 
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SOFTWARE-BASED CURRICULUM CREATE YOUR ELECTRONICS 
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Use your Raspberry Pi from any other machine on your network 
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Tutorial 


BUILD AN 


Make your own oscilloscope using a Raspberry Pi and an Arduino 


Youll 


Need he oscilloscope is on the wish list of anyone to £5000 and beyond. However, by using an Arduino 
Starting out with electronics. Your author and some software on the Raspberry Pi, you can make 
used to tell his students that it was your eyes, a passable beginner’s oscilloscope. 

° seca oF on making electricity visible. Unfortunately, they are Last September, in The MagPi #61, there was an 
AVR-based quite expensive: from a few hundred pounds to up article outlining the way the Raspberry Pi and the 


Arduino 


>3x10kQ 
potentiometers 


>4x100kQ , 
resistors s Bo 


: Pil | ||) Voltage 164 V 
>1~x 1kQ resistor pat ) Seved Voltage 1.73 
AVoltage -3.37 V 


>1x 1uUF : Time 2635, pS 
! ' ; Saved Time 1649. uS 
| ATime 906.0 uS 

VATime 1014. Hz 


capacitor Signal generator providing 
a test sweep waveform 


Time 544uS per division Voltage 625mV per division 
x 
me 47 Br Time Magnify Voltage Magnity Measure Save 
oy xi x2 xd xB x16 x32 xi x2 x4 Time Volte Time Volts 
Capacitors a x Time vi 


> BNC panel 
mounting 
socket 


> Box Oscilloscope waveform 
with time and voltage 
> Various, nuts LEE measurements 
bolts, and Lj 
spacers 


Oscilloscope 


> Stripboard 


Do not use this on 
mains electricity! 


Tutorial 


5V 
5V 
47uF 
100K 100K l 
5V Arduino ae 
1uF Ad i 
" Voltage Trigger 
ail A3 Cursor Voltage 
10K 10K 
47uF 100K 100K USB AA 
1K Gnd 
\ 
S Schematic 
To Raspberry Pl of the Arduino 


BNC Input Socket USB acquisition module 


Arduino could be used together. We at the Bakery 
have been doing this for some time: we first had a 
major project in the Raspberry Pi Projects books by 
Andrew Robinson and Mike Cook. The big advantage 
of the Arduino from a signal processing point of 
view is that there is minimal interruption from 


the operating system and you can gather data ata >STEP-O1 

constant uninterrupted rate. This is just what we Gathering the parts 

need for making an oscilloscope. The idea is that the 

Arduino gathers a whole heap of voltage samples We used an Arduino Nano and soldered the header pins to 


it. Then we took a 14 hole by 19 strips piece of stripboard and 
drilled some holes to fix it to the base of the box. You might 
want to make this longer than 19 strips if you are not using 
surface-mount resistors on the underside. Fit header sockets 
to the stripboard and break the tracks on the underside 
between the two rows. 


as fast as it can and stores it in memory. It then 
transfers that memory to the Raspberry Pi, again as 
fast as possible. The Pi plots the data and displays it, 
then the software allows measurements to be made 
on the samples. 

So you can measure the time and voltage 
difference, known as a delta, between any two points 
on the samples. You can even display the frequency 
that the ‘time delta’ corresponds to by taking its 
reciprocal. These are features found in expensive 
oscilloscopes. We have also built in a trigger 
function; this is to synchronise the onset of the rapid 
data gathering with the occurrence of a positive 
transition on the input signal through a specified 
voltage. The result is that regular waveforms can look 
stable on the display. 


The hardware 

The schematic of the Arduino data acquisition 
module is shown in Figure 1. You will notice that it is 
quite simple. It consists of three potentiometers for 
the oscilloscope’s controls and an AC coupled biased 
voltage input. The capacitor ensures that no DC 
components from the input get through and gives a 
modicum of protection for overvoltage. The reference 
voltage, or ground, is similarly biased as +2.5V above 
the Pi’s ground level. The use of a BNC socket for 

the input ensures that you can use this with proper 
oscilloscope probe leads; these normally have an X10 
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switchable attenuator fitted, thus allowing voltages 
of +/- 25V to be measured. Full construction details 
can be found in the numbered steps. 


Arduino software 

The software, or sketch, you need to put into the 
Arduino is shown in the Gather_Ao.ino listing, 

and is quite simple. Normally an Arduino of this 
type will take samples at a rate of 10000 per second 


It proved to be a lot more 
tricky to write than we 
first imagined 


— OF as we Say, a10k sample rate. This is not too good 
for an oscilloscope, but we can increase this sample 
rate by speeding up the A/D converter’s clock speed 
from the default rate. It does not appear to affect the 
reading accuracy too much. By making this change, 
we can speed up the sample rate to 58k. This is much 


>STEP-02 


Adding access holes 


The BNC socket has a flat on each side of the 
thread, this is to prevent it rotating with the 
twisting force it will be subjected to upon 
connecting any probe. We did this by first 
drilling an 8mm hole for the flats and then 
enlarging the hole with a circular file on each 
side to allow it to fit. An 8x12 mm hole was filed 
opposite the USB connecter to allow access. 


better and allows useful measurements to be made 
in the audio range. 

So, first, the trigger function is optionally called 
and then the samples are gathered in and sent to the 
Pi. The trigger function has a time-out which means 
it will trigger anyway after one second, whether it 
sees a transition on the input signal or not. Then the 
three pots are measured and also sent to the Pi. Note 
here that the samples are ten bits wide and so have to 
be sent as two bytes that get joined together again in 
the Pi’s software. 

Also note the use of the double read for the pots, 
with a bit of code between each. This ensures a 
more stable reading as the input capacitor of the 
Arduino’s sample and hold circuit needs time to 
charge up, and it has less time than normal to 
do this due to the speeding up of the D/A. It does 
not effect the waveform samples too much as in 
most waveforms one sample voltage is close to the 
previous one. 

At the end of the transfer, the Arduino sits ina 
loop waiting for an acknowledge byte from the Pi so 
it can Start again. This acknowledge byte also carries 
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>STEP-03 
Wiring the pots 


We then drilled three holes for the pots, and 
added the small slots for the anti-rotation lugs. 
Then we fitted the pots and wired them up using 
the diagram above. This is the view from inside the 
lid of the box; if you're worried about touching the 
side of the box with your soldering iron, consider 
soldering them before attaching to the box. 


the information as to whether to use a trigger or not 
on the next sample. 

Finally, before each buffer full of data is gathered, 
pin 13 on the board is lit, and turned off after. This is 
so that we could time the process on a commercial 
oscilloscope to find the sample rate — something you 


will not have to do if you use the recommended AVR- 


type Arduinos running at 16MHz. 


Pi software 

The software for the Raspberry Pi is written in 
Python 3 and used the Pygame framework. It proved 
to be a lot more tricky to write than we first imagined, 
and is shown in the Scope.py listing. Python 3 uses 
Unicode characters by default, and allowed us to 
display the delta (A) and mu (py) Greek characters for 
the difference and the time. The code first sets up the 
non-display part of the window, this is only drawn 
once and then parts of it are updated when necessary. 
Depending on what type of Arduino you have, it can 
show up as a different USB port; we found that ours 
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>STEP-04 


Finishing off 


Add the resistors and capacitors to the 
stripboard and wire up the BNC socket. Solder 
this up before mounting, otherwise you will 
melt the plastic. Remember to thread the 
central wire through the ground washer, 
crinkle washer, and nut before soldering 

it. Add labels Trigger, Time, and Volts to 

the knobs. 


Tutorial DW Wart: 


Figure 2 Taking measurements on a swept signal 


showed up as one of two ports. Comment out which 
one is not applicable when defining the sampleInput 
variable at the start of the listing. 

Finally, we cobbled together a 16878 pixel logo 
for the top-left corner, using a piece of clip art 
and fashioning the word ‘Oscilloscope’ from an 
outlined version of the Cooper Black font. We called 
it PyLogo. png and placed it in an images folder next 
to the Python code. 


Using the oscilloscope 

The oscilloscope samples at 58 kHz, which in theory 
means you can measure waveforms at 29 kHz. But 
that only gives you two samples per cycle and as 

the samples can be anywhere on the waveform, 
they do not look very good. As a rough guide, you 
need at least ten points on a waveform to make it 
look like a waveform, so that gives a top practical 
frequency of 5.8 kHz. However, by using the Time 
Magnify options along with the freeze function, you 
can measure much higher frequencies. The time and 
voltage cursor lines let you find out the values on 
any point of the waveform, and by clicking the save 
functions the current cursor is replaced by a dotted 
line which is fixed, and measurements can be made 
relative to that. The oscilloscope in action can be 
seen in Figure 2. Note that pressing the S key on the 
keyboard produces a screen dump of the display. 


Taking it further 

There are lots of ways you can take this project 
further. A simple upgrade would involve you having 
a second data buffer to allow you to display a saved 
waveform to compare against the current live one. 
You could also add a lower speed acquisition mode 
to see slower waveforms. You can go the other 

way and use a faster Arduino so you can see the 
higher frequencies. This oscilloscope is AC coupled; 
you could add a DC coupling option with a switch 
potential divider and amplifier to the front end to 
extend the range of voltages you can measure. All 
these improvements, however, will need changes to 
the software to allow the measuring to take place on 
these wider-range parameters. 
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Gather _ 110.ino 


a 
0@3. 
004. 
005. 
006. 
007. 
008. 
0e9. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
620. 
621. 
022. 
023. 
024. 
925. 
026. 
027. 
628. 
629. 
030. 
931. 
032. 
933. 
934. 
935. 
036. 
037. 
038. 
939. 
040. 
041. 
042. 
043. 


045. 
046. 
047. 
048. 
049. 
@50. 
951. 
@52. 
053. 
054. 
055. 
056. 


057. 


int buffer [512]; // 1K input buffer 

int sample, lastSample; 

int poti, triggerVoltage; 

int triggerTimeout = 1000; // time until auto trigger 
unsigned long triggerStart; 

char triggerType = ‘2’; 


void setup(){ 
Serial .begin(115200) ; 
pinMode(13,OUTPUT) ; 
// set up fast sampling mode 
ADCSRA = (ADCSRA & @xf8) | 0x04; // set 16 times division 


void loop(){ 
if( triggerType != '2') trigger(); // get a trigger 
digitalWrite(13,HIGH);// timing marker 
for(int i=@; i<512 ; i++){ 
buffer[i] = analogRead(@); 
} 
digitalWrite(13,LOW); // timing marker 
pot1i = analogRead(2); // switch channel to cursor pot 
for(int i1=@; i<512 ; i++){ 
Serial .write(buffer[i]>>8); 
Serial.write(buffer[i] & OxfFf); 
} 
// send back pot values for cursors 
pot1 = analogRead(2); 
analogRead(3); // next cursor pot 
Serial.write(pot1>>8) ; 
Serial.write(pot1 & OxfFf); 
pot1 = analogRead(3); 
triggerVoltage = analogRead(4); 
Serial.write(pot1>>8) ; 
Serial.write(pot1 & OxfFf); 
triggerVoltage = analogRead(4); 
pot1l = analogRead(@); // prepair for next sample run 
Serial.write(triggerVoltage>>8s) ; 
Serial.write(triggerVoltage & @xff); 


while(Serial.available() == @) { } // wait for next request 
triggerType = Serial.read(); // see what trigger to use 
while (Serial.available() != 0) { // remove any other bytes 
in buffer 
Serial.read(); 


void trigger(){ 

// trigger at rising zero crossing 

triggerStart = millis(); 

sample = analogRead(@); 

do { 

lastSample = sample; 

sample = analogRead(@); 

} 

while(!(lastSample < triggerVoltage && sample 
> triggerVoltage) && (millis() - triggerStart < 
triggerTimeout) ); 


} 
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048. checkForEvent () 
cope.py 049. while run[4]: # if in 
>C/C+t 


hold mode wait here 


Q@1. import serial, pygame, os, time Q50. qieseear > aTeO >PYTHON 3 
sim Q@51 if run[3]: 
Q@3. pygame.init() pan — tail ve writen) DOWNLOAD: 
Q@4. os.environ['SDL_VIDEO WINDOW _POS'] = ‘center’ ; vs nt magpi.cc/4aNqJjmV 
On disol Zé Rion ( tard’ / Pi Oscill ") # tell Arduino to get an other 
; ame.display.set_caption("Arduino i Oscilloscope 
Pyg play _cap p pecans PROJECT 
006. pygame.event.set allowed(None) 
053. else: VIDEOS 
007. pygame.event.set allowed([pygame.KEYDOWN, pygame. o5A Tear 
P SampleInput. 
MOUSEBUT TONDOWN , ame.QUIT, ame .MOUSEBUT TONUP : a 
FUE 2 Be 1) write(b'2') # buffer but no Check out Mike's 


008. Bakery videos at: 


@@9. textHeight=22 ; font = pygame.font.Font(None, textHeight) eiteeer magpi.cc/DsjbZK 
@10. screenWidth = 720 ; screenHight = 360 aa 
Q@11. screen = pygame.display.set mode([screenWidth, jae hak pace) 
screenHight],0, 32) 057. | PY¥sale gral Pect Cate Peay Cesena) C232: 
Q@12. display = pygame.Surface( (512,256) ) gt speayntacl Gis prayisent)s€) 
013. backCol = (150,150,100) ; black = (@,0,0) # background ae Fe WN) ADRS Aeon se) oy" Clee ln ae agikest 
Pattee Q59. pygame. draw. line(display, (120,120,120), (@,h), 
014. pramCol = (200,200,150) # parameter colour (825M) 
015. logo = pygame.image.load("images/PyLogo.png").convert_ 2k Fee Ee Un) Une) gels 1 gee) oes cles) Waite sit 
alpha() 061. pygame.draw. line(display, (120,120,120), (v,@), 
016. (v5256 Fh) 
017. sampleInput = serial.Serial("/dev/ttyUSB0" ,1152@e, 062. pygame draw. line(display, (0,0, 0), (256,0), (256, 256),1) 
timeout = 5) # For Mega or nano 063. pygame.draw.line(display, (0,0,0), (0,128), (512,128) ,1) 
Q18. #sampleInput = serial.Serial("/dev/ttyACMo", 115200, ge: 
timeout = 5) # For Uno @65. def drawControls(): 
Q19. 066. drawwords("Time Magnify",10,300,black, backCol) 
@20. displayWidth = 512 ; displayHight = 256 067. drawWords("Voltage Magnify", 220, 30@,black,backCol) 
@21. LedRect = [ pygame.Rect((0,0),(0,0))]*17 068. drawwWords("Measure", 440, 300,black, backCol ) 
@22. inBuf = [0]*512 # quick way of getting a 512 long buffer 969: drawWords(" Time” ,440,320,black,backCol) 
@23. chOff = displayHight//2 # Channel Offset 070. drawwords("Volts",486, 320,black, backCol) 
@24. run = [True,False,False,True,False] # run controls e71. drawWords(" Save” 540, 300, black, backCol) 
@25. expandT = 1 ; expandV = 1 # voltage & time expansion Q72. drawWords(" Time” ,540,320,black, backCol) 
Q26. 073. drawwords("Volts",586,320,black, backCol ) 
@27. sampleTime = 17 # uS for 58KHz sample 074. drawwords("1/"+chr(@x394)+"Time",540,257,black, 
@28. smples_cm = 32 * sampleTime backCol) 
@29. volts sample = 5/1024 # volts per sample 075. drawwords(chr(@x394)+"Time" ,540,237,black, backCol) 
@30. measureTime = False ; measureVolts = False;savedTime = 076. drawWords("Saved Time" ,54@,217,black,backCol) 
@;savedVoltage = 2 077. drawWords("Time",540,197,black, backCol) 
@31. cursorT = @; cursorV = @; vMag = 1; svLed = False; 078. drawwWords(chr(@x394)+"Voltage" ,540,167, black, backCol) 
stLed = False 079. drawwords("Saved Voltage" ,540,147,black, backCol) 
@32. triggerc = 512 ; savedVoltsC = -1 ; savedTimeC = -1 880. drawWords("Voltage" ,54@,127,black, backCol) 
@33. 081. drawWords("Run Single Freeze Trigger", 
@34. def main(): 540,77,black,backCol) 
@35. pygame. draw. rect(screen, backCol, (8,2, screenWidth, Q82. screen.blit (logo, (540,2) ) 
screenHight+2) ,0) 083. updateControls (True) 
@36. defineControls() 084. 
037. drawControls() @85. def updateControls(blank): 
Q38. time.sleep(9.1) Q86. global vDisp 
@39. sampleInput.flushInput() # empty any buffer contents 987. if blank: 
040. sampleInput.write(b'2') # tell Arduino to get a new 088. pygame.draw.rect(screen, backCol, resultsRect, 0) 
buffer 089. if expandT*smples_ cm >= 1000: 
041. while(1): 990. drawWords("Time "+str((expandT*smples_cm)//1000) 
042. time.sleep(@.001) # let other code have a look in +"mS per division ",10,280,black,backCol) 
043. readArduino() # get buffer data 991. else: 
044. plotWave() # draw waveform 992. drawWords("Time "+str(expandT*smples_cm)+ 
045. if measureTime or measureVolts : "uS per division ",10,280,black, backCol) 
046. updateControls(True) 993. volts _cm = int(volts_sample*128*1000/expandV) 
047. drawScope() # display new screen 994. drawWwords("Voltage "+str(volts_cm)+"mV per division", 
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995. 
096. 


097. 
098. 
999. 


100. 
101. 
102. 
103. 
104. 
105. 
106. 
107. 
108. 
109. 


110. 
a Va bs 


112. 
113. 


114. 
15. 


116. 
117. 


118. 
119. 


120. 
121. 
122. 
123. 
124. 
125. 
126. 
127. 
128. 
A297 
130. 
131. 
132. 
133. 


134. 
135. 
136. 
137. 
138. 
139. 
140. 


220, 280,black, backCol) 
for n in range(@,6): # time option LED 
drawWords("x"+str(1<<n) ,10+n*30, 320,black, 
backCol) 
drawLED(n,expandT == 1<<n) 
for n in range(6,9): # voltage options 
drawWords("x"+str(1<<(n-6)), 220+ 
(n-6)*3@,320,black, backCol) 
drawLED(n,expandV == 1<<(n-6)) 
drawLED(9,measureTime) 
drawLED(1@,measureVolts) 
drawLED(11, stLed) 
drawLED(12,svLed) 
for n in range(13,17): 
drawLED(n, run[n-13]) 
if measureTime : 
t = (cursorT>>1)*sampleTime / expandT 
drawWords(" "+trunk(t,5)+" “+chr(@x3bc)+"S" ,640, 
197,black,pramCol) # current time 
drawWords(" "+trunk(savedTime,5)+" "“+chr(@x3bc)+ 
"S",640,217,black, pramCol ) 
drawWords(" "+trunk(t-savedTime,5)+" "+chr(@x3bc) 
+"S",640,237,black,pramCol) # delta time 
if t-savedTime != 0 : 
drawWords((trunk(19@e@ee0 / abs(t-savedTime) ,5) ) 
+" Hz" ,640,257,black, pramCol ) 
if measureVolts : 
vDisp = (((1024-cursorV)>>2)-128)*volts_sample * 


vMag 

delta = vDisp - savedVoltage 

drawWords(" "+trunk(delta,4)+ 
"V" ,640,167,black, pramCol ) 
drawWords(" "+trunk(savedVoltage,4)+ 
"V" ,640,147,black, pramCol ) 

drawWords(" "“+trunk(vDisp,4)+ 


"V" ,640,127,black, pramCol ) 


def trunk(value, place): # truncate a value string 
v=str(value)+"000000" 
if value>@: 
v = v[@:place] 
else: 
v = v[@:place+1] # extra place for the minus sign 
return v 
def drawLED(n,state): # draw LED 
if state : 
pygame.draw.rect(screen, (240,8,8),LedRect[n], 0) 
else : 
pygame.draw.rect(screen, (240, 240, 240), 


LedRect[n],®) 


def defineControls(): 
global LedRect, resultsRect 
for n in range(@,6): 
LedRect[n] = pygame.Rect((10+n*30, 336),(15,15)) 
for n in range(6,9): 
LedRect[n] = pygame.Rect( (220+ 
(n-6)*30, 336), (15,15)) 
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141. 
142. 
143 e 


144. 


145. 
146. 
147. 
148. 


149. 
150. 
Si: 
q52.. 
153. 
154. 
155. 
156. 
i157; 
158. 
159. 
160. 
161. 
162. 
163. 
164. 


165. 
166. 
167. 
168. 
169. 


170 e 
i7 i. 
172, 


73s. 
174. 


75: 
176. 
177. 


178. 
179. 
180. 
181. 


182. 
183. 
184. 
185. 
186. 
187. 
188. 
189. 
190. 


LedRect[9] = pygame.Rect((440,336),(15,15)) # time 

LedRect[10] = pygame.Rect((486,336),(15,15)) # volts 

LedRect[11] = pygame.Rect((540,336),(15,15)) # save 
time 

LedRect[12] = pygame.Rect((586,336),(15,15)) # save 
volts 

LedRect[13] = pygame.Rect((545,100),(15,15)) # run 

LedRect[14] = pygame.Rect((580,100),(15,15)) # single 

LedRect[15] = pygame.Rect((628,100),(15,15)) # freeze 

LedRect[16] = pygame.Rect((676,100),(15,15)) # 
trigger 

resultsRect = pygame.Rect( (639,125), (90,153) ) 


def plotWave(): 
global vMag 
lastX=0 ; lastY=0 
vMag = 2 # 
if expandV 
vMag = 4 


adjust voltage scale 


if expandV 
vMag =1 

drawGrid() 

Ss = @ # sample pointer 


for n in range(®@, displayWidth, expandT): 
y = (512-inBuf[s])//vMag + chOff 
te fle (a 
pygame. draw. line(display, (0, 200,@), 
(lastX ,lastY), (n ,y ),2) 
lastX =n 
lastY = y 
s += 1 
if measureTime : 
pygame.draw. line(display, (@,9,255), 
(cursorT>>1,0), (cursorT>>1,256),1) 
if savedTimeC != -1: 
for n in range(@,256,12): 
pygame. draw. line(display, (2,9, 255), 
(savedTimeC,n), (savedTimeC,n+6),1) 
if measureVolts : 
pygame.draw. line(display, (255,08,@), 
(@,cursorV>>2), (512,cursorV>>2),1) 
if savedVoltscC != -1: 
for n in range(@,512,12): 
pygame.draw. line(display, (255,0,@), 
(n, savedVoltsC) , (n+6,savedVoltsC),1) 
if run[3] : # use trigger 
y = (triggerc-512)//vMag + chOff 
for n in range(@,512,12): 
pygame.draw. Line(display, (255,128,8),(n,y), 
(n+6,y),1) 


def drawScope(): # put display onto scope controls 
screen.blit(display, (10,10) ) 
pygame.display.update() 


def drawWords(words,x,y,col,backCol) : 
textSurface = font.render(words, True, col, backCol) 
textRect = textSurface.get_rect() 
textRect.left = x 
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191. textRect.top = y 241. if LedRect[14].collidepoint(pos): # single 
192. screen.blit(textSurface, textRect) 242. run[1] = True 
193. 243. run[@] = False 
194. def readArduino(): # get buffer and controls 244. run[2] = False 
195. global cursorT, cursorV, triggerC, run 245. run[4] = True 
mn sly g pus te ere i funnel data into junk oAG. ipdaeeeonthor= (pales) 
198. junk = sampleInput.read() wma Bee P et) 
199. Biicat 4 Gcheriies ead arno the bureer 248. if LedRect[15].collidepoint(pos) and not run[1]: # 
200. for i in range(@,512): freeze 
201. inBuf[i] = ((ord(sampleInput.read())) << 8) | 249. run[2] = not(run[2]) 
ord(sampleInput.read()) 250. if eno FunL 2): 
202. cursorT = ((ord(sampleInput.read())) << 8) | 251. run[@] = True 
ord(sampleInput.read() ) 252. else: 
203. cursorv = 1024 - (((ord(sampleInput.read())) << 8) | 953. run[@] = False 
ord(sampleInput .read())) 254. if LedRect[16].collidepoint(pos): # trigger 
204. triggerC = 1024 - (((ord(sampleInput.read())) << 8) | 555. Bun noe Guna) 
sie Sie, aly aia uae 256. updateControls(False) 
205. if run[1]: #single sweep requested 
206. run[1] = False le 
207. run[2] = True # put in freeze mode 258. def handleMouseUp(pos): # look at mouse up 
208. updateControls(True) 259. global savedVoltage,savedTime, svLed, stLed, run 
209. 260. if LedRect[12].collidepoint(pos) and measureVolts: 
210. def handleMouse(pos): # look at mouse down 261. savedVoltage = vDisp 
211. global expandT,expandV,measureTime,measureVolts,svLed, 262. svLed = False 
stLed 263. updateControls(False) 
ones global savedVoltsC, savedTimeC, run 264. if LedRect[11].collidepoint(pos) and measureTime: 
ae open (pe) 265. SavedTime = (cursorT>>1)*sampleTime / expandT 
214. for n in range(@,6) : 266. Bree eee 
215. if LedRect[n].collidepoint(pos): 
716. expand Secon 267. updateControls(False) 
217. for n in range(6,9) : 268. if LedRect[14].collidepoint(pos): # single 
218. if LedRect[n].collidepoint(pos): 269. run[4] = False 
219. expandV = 1<<(n-6) 270. updateControls(False) 
220. if LedRect[9].collidepoint(pos): #toggle time 271. 
measurement 272. def terminate(): # close down the program 
221. measureTime = not(measureTime) 273. pygame.quit() # close pygame 
222. if not measureTime : 274. os. _exit(1) 
223. SavedTimeC = -1 275. 
ae se ICT tee eee ee 276. def checkForEvent(): # see if we need to quit 
225. measureVolts = not(measureVolts) # toggle volts 
2 eee 277. event = pygame.event.poll() 
226. Sh nak eacimaoite © 278. if event.type == pygame.QUIT : 
227. savedVoltsC = -1 279. terminate() 
228. if LedRect[11].collidepoint(pos) and measureTime: # 280. if event.type == pygame.KEYDOWN : 
save time 281. if event.key == pygame.K_ESCAPE : 
229. stLed = True 282. terminate() 
230. SavedTimeC = cursorT>>1 283. if event.key == pygame.K_s : # screen dump 
231. if LedRect[12].collidepoint(pos) and measureVolts: # 284. os.system("scrot -u" 
nave vor 285. if event.type == pygame.MOUSEBUTTONDOWN : 
od eae ee citeonyale 286. | handleMouse(pygame.mouse.get_pos()) 
aa. ah contolebiseie 287. if event.type == pygame.MOUSEBUTTONUP : 
235. if LedRect[13].collidepoint(pos) and not run[1]: # run a Bernd oue eto py eae mouee mets eC) 
236. run[@] = not(run[@]) ss 
237. if not run[Q]: 290. 
238. run[2] = True 291. # Main program logic: 
239. else: 292. if _name_ == '_main_': 
240. run[2] = False 293. main() 
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Tutorial STEP BY STEP 


GET STARTED WITH 
PYGAME ZERO 


Pygame Zero is a great choice for anyone who wants to start writing 
computer games on the Raspberry Pi 


f you’ve done some Python coding and wanted >9S!EP-01 


Raspbian Jessie to write a game, you may have come across Loading a suitable program editor 
ee Pygame. The Pygame module adds many The first really labour-saving thing about Pygame 
An image functions that help you to write games in Python. Zero is that you can write a program in a simple text 
sfogiom sue Pygame Zero goes one step further to let you skip over _ editor. For the easiest route we suggest using the IDLE 
as GIMP the cumbersome process of making all those game Python 3 editor, as Pygame Zero needs to be formatted 
Alittle loops and setting up your program structure. You like Python with its indents and you’ll get the benefit 
imagination don’t need to worry about functions to load graphics of syntax highlighting to help you along the way. 
Akeyboard or keeping data structures for all the game elements. So the first step in your journey will be to open the 
If you just want to get stuck in and start making Python 3 IDLE editor from the Raspbian main menu, 
things happen on the screen without all the fluff, then under Programming. You’ll be presented with the 
Pygame Zero is what you need. Python Shell window. 
The Python Shell | 
window that (2) BD 2 CB | Arrtronassshet [Race Game Los _ spony nome. pesos 0 gare Zeo Game | GNU image Manipul.||\V2] % S a) [asx] 1915 A 
appears when Python 3.5.3 Shel Sox racel_py - /home/pi/racel py (3.5.3) -ox 


file Gdr Shell Debug Options window Help 
Python 3.5.3 (default, Jan 19 2617, 14:11:64) 


file §dit cm Run _Sptiona Window Help 


we open IDLE 


GCC 6.3.0 20170124] on linux WIDTH = 700 * Width of window 
ype “copyright”, "credits" or "license()" for more informat | || HEIGHT = 800 # Height of win — 
re) i i’ |¢ar = Actor("“racecar") # Load in the car Actor image 
r r r m 77? |car.pos = 256, 766 # Set the car screen position 
u p og a Siesessssssssssssssses= RESTART: /home/pi/ygamezero.py ===== | SPEED = 4 


SERSECESSCSESEELEL | trackcount = 6 

trackPosition = 256 

trackWidth = 120 

trackDirection = fa 

trackteft = [] ¢ list yf tract barriers left 

| trackRight ={) #@ track barriers right 
| gameStatus =0 


listing. This is a file 
window from the 
IDLE application 


| def draw(): * Pyqame Zero draw function 


glebal gameStatus 
screen.fill((126, 128, 128)) 
* gameStatus == @: 


i 


The Terminal 
window -— enter the 
command to run 
our program 


car .draw{) 
b=0 


while b < len(trackLeft): 

trackLeft[b] .draw() 
Seennanes draw() 
b+ 


f ganestatus ee 
0 Red Flag 
screen.blat('rfleg', (318, 268)) 

if gameStatus == 2: 

# Chequered Flag 

screen.blit(‘cflag', 


of eal a # Pygame Zero update function 
al gameStatus , trackCount 
= i ‘ganestatus == 6: 


(318, 268)) 


TERMINAL 


SHORTCUTS , 6(6tS She 
| i yboard.left: car.x -= 2 
Un 6 Cold | af keyboard.right: car.x += 2 
pi@raspherrypi ~ _orx updateTrack( ) 


if trackCount >» 200: gameStatus = 2 # Chequered flag state 


File Edit Tabs Help 


> 


Instead of 


retyping 
pgzrun 


f makeTrack(): Function to make a new section of track 
at crescent, trackLeft, gpg trackPosition, trackwWidth 
trackLeft. append(Actor("barrier", pos = (trackPosition-trackwidth,96))}) 
trackRight .append(Actor(” barrier” » pos = (trackPosition+trackwidth,®@))) 
trackGount += 1 


ef updateTrack(): # Function to update where the track blocks appea 
global trackCount, trackPosition, trackDirection, trackwidth, qanedtatus 


racel1.pyin 
the Terminal 
window, you 
can use the 


Lf trackDirection == False: trackPosition += 16 
if trackDirection == True: trackPosition -= 16 
up arrow to if randint(®, 4) == 1: “trackDirection = sot trackDirection 
! trackPosition > -7e0- trackWidth: trackDirection = True 


while b < len(trackLeft): 
if car. ee eee A yw car.colliderect(trackRight[b]): 
QameStatus «= $i ate 

trackLeft(b].y + 

abe pete iy = SEED 


trackLeft[ le pn( trackLeft)- 2). y > 32: 


if trackPosition < trackWidth: trackDirection = false 
makeTrack() 


repeat the last 
command. 


ls End of funct 
makeTrack() # Make first block of track 
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>STEP-02 

Writing a Pygame Zero program 

To start writing your first Pygame Zero program, go 
to the File menu of the IDLE Python Shell window 
and select ‘New File’ to open up a new editor window 
— and that’s it! You have written your first Pygame 
Zero program! The Pygame Zero framework assumes 
that you will want to open a new window to run your 
game inside, so even a blank file will create a running 
game environment. Of course at this stage your game 
doesn’t do very much, but you can test it to make sure 
that you can get a program running. 


>STEP-03 

Running your first Pygame Zero program 

With other Python programs, you can run them 
directly from the Python file window. Currently IDLE 
does not support running Pygame Zero programs 
directly, but the alternative is very simple. First of all, 
you need to save your blank program file. We suggest 
Saving it aS pygamel1.py in your default user folder 
(just save the file without changing directory). All you 
need to do then is open a Terminal window from the 
main Raspbian menu and type pgzrun pygame1.py 
(assuming you called your program pygamet.py) and 
hit RETURN. After a few seconds, a window titled 
‘Pygame Zero Game’ should appear. 


>STEP-04 

Setting up the basics 

By default, the Pygame Zero window opens at the 

size of 800 pixels wide by 600 pixels high. If you 

want to change the size of your window, there are 

two predefined variables you can set. If you include 
WIDTH = 70@ in your program, then the window will 
be set at 700 pixels wide. If you include HEIGHT = 8@@, 
then the window will be set to 800 pixels high. In this 
tutorial we’ll be writing a simple racing game, so we 
want our window to be a bit taller than it is wide. When 
you have set the WIDTH and HEIGHT variables, you could 
save your file as race1.py and test it like before by 
typing pgzrun race1.py into the Terminal window. 


>STEP-05 

Look! No game loop! 

When writing a Python game, normally you would 
have a game loop — that’s a piece of code that is run 
over and over while the game is running. Pygame 
Zero does away with this idea and provides predefined 
functions to handle each of the tasks that the game 
loop normally performs. The first of these we will look 
at is the function draw(). We can write this function 
into our program the same as we would normally 
define a function in Python, which is def draw():. 
Then, so that you can see the draw function doing 
something, add a line underneath indented by one 

tab: screen.fil1((128, 128, 128)). This is shown 
in the figure1.py listing overleaf. 
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GET STARTED WITH PYGAME ZERO 


racel.py 


>PYTHON 
from random import randint 

WIDTH = 700 # Width of window 

HEIGHT = 800 # Height of window 

car = Actor("racecar") # Load in the 
car Actor image 

car.pos = 250, 700 # Set the car screen position 
SPEED = 4 

trackCount = @ 

trackPosition = 250 

trackWidth = 120 

trackDirection = False 

trackLeft = [] # list of track barriers left 
trackRight = [|] # list of track barriers right 
gameStatus = 9 


DOWNLOAD: 
magpi.cc/VcqutR 


def draw(): # Pygame Zero draw function 
global gameStatus 
screen, fill (1285 128; 128 )) 
if gameStatus == @: 
car.draw() 
= 
while b < len(trackLeft): 
trackLeft[b].draw() 
trackRight[b].draw() 
b += 1 
if gameStatus == 1: 
# Red Flag 
screen.blit('rflag', (318, 268)) 
if gameStatus == 2: 
# Chequered Flag 
screen.blit('cflag', (318, 268)) 


def update(): # Pygame Zero update function 
global gameStatus , trackCount 
if gameStatus == @: 
if keyboard.left: car.x -= 2 
if keyboard.right: car.x += 2 
updateTrack() 
if trackCount > 200: gameStatus = 2 # Chequered flag 
state 


def makeTrack(): # Function to make a new section of track 

global trackCount, trackLeft, trackRight, trackPosition, 
trackWidth 

trackLeft.append(Actor("barrier", pos = (trackPosition- 
trackWidth, @))) 

trackRight.append(Actor("barrier", pos = 
(trackPosition+trackWidth, @) ) ) 

trackCount += 1 


def updateTrack(): # Function to update where the track 
blocks appear 
global trackCount, trackPosition, trackDirection, 
trackWidth, gameStatus 
Dae 
while b < len(trackLeft): 
if car.colliderect(trackLeft[b]) or 
car.colliderect(trackRight[b]): 
gameStatus = 1 # Red flag state 
trackLeft[b].y += SPEED 
trackRight[b].y += SPEED 


b += 1 

if trackLeft[len(trackLeft)-1].y > 32: 
if trackDirection == False: trackPosition += 16 
if trackDirection == True: trackPosition -= 16 


if randint(@, 4) == 1: trackDirection = not 
trackDirection 

if trackPosition > 700-trackWidth: trackDirection = 
True 

if trackPosition < trackWidth: trackDirection = 
False 

makeTrack() 


# End of functions 
makeTrack() # Make first block of track 
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Tutorial 


>STEP-07 


figurel.py All the world’s a stage 
The screen object used in Step 5 is a predefined 


Q@1. WIDTH = 7202 object that refers to the window we’ve opened for 
Q@2. HEIGHT = 800 our game. The fill function fills the window with 
Q@3. the RGB value (a tuple value) provided — in this 

Q4. draw(): case, a Shade of grey. Now that we have our stage 
Q5. screen. ((128), 1285 1228) ) set, we can create our Actors. Actors in Pygame Zero 


are dynamic graphic objects, much the same as 
Sprites in other programming systems. We can load 


ae hoard >STEP-06 an Actor by typing car = Actor("racecar"). This 
width ofaPygame The Python format is best placed near the top of your program, before 


Zero window, just 


You may have noticed that in the previous step we the draw() function. 
set the variables . 
HEIGHT andWIDTH. Said to indent the screen. fill line by one tab. 
oe Pygame Zero follows the same formatting rules as >STEP-08 
acolour Python, so you will need to take care to indent your It’s all about image 
code correctly. The indents in Python show that the When we define an Actor in our program, what 
code is inside a structure. So if you define a function, we are actually doing is saying ‘go and get this 


image’. In Pygame Zero our images need to be 


Actors in Pyg ane VAs ro are stored in a directory called images, next to our 


program file. So our Actor would be looking for an 
dyn AMIC ¢ raphic ob} ects image file in the images folder called racecar.png. 
) It could be aGIF or a JPG file, but it is recommended 
that your images are PNG files as that file type 
much the salne as Sprite S provides good-quality images with transparencies. 
You can get a full free image creation program 
all the code inside it will be indented by one tab. called GIMP by typing sudo apt-get install gimp 
If you then have a condition or a loop, for example an in your Terminal window. If you want to use 
if statement, then the contents of that condition will our images, you can download them from 
be indented by another tab (so two in total). magpi.cc/srHWWH. 


Right To respond 
to key presses, 
Pygame Zero has 
a built-in object 
called keyboard. 
The arrow key 
states can be read 
with keyboard. up, 
keyboard. down, 
and so on 


THE 
GRAPHICS 


If you use 
PNG files for 


your graphics 
rather than 
JPGs, you can 
keep part of 
the image 
transparent. 
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>STEP-O09 

Drawing your Actor 

Once you have loaded in your image by defining 
your Actor, you can set its position on the screen. 
You can do this straight after loading the Actor by 
typing car.pos = 250, 5@@to Set it at position 
250, 500 on the screen. Now, when the draw() 
function runs, we want to display our race car 

at the co-ordinates that we have set. So, in our 
draw() function, after the screen. fill command 
we can type car.draw(). This will draw our race 
car at its defined position. Test your program to 
make sure this is working, by saving it and running 
pegzrun racel.py as before. 


>STEP-10 

I'm a control freak! 

Once we have our car drawing on the screen, 

the next stage is to enable the player to move 

it backwards and forwards. We can do this with 
key presses; in this case we are going to use the 
left and right arrow keys. We can read the state 
of these keys inside another predefined function 
called update(). We can type in the definition 
of this function by adding def update(): to our 


program. This function is continually checked while 


the game is running. We can now add an indented 
if statement to check the state of a key; e.g., 
if keyboard.left:. 


>STEP-11 

Steering the car 

We need to write some code to detect key presses 
of both arrow keys and also to do something 
about it if we detect that either has been pressed. 
Continuing from our if keyboard.left: 

line, we can write car.x -= 2. This means 
subtract 2 from the car’s x co-ordinate. It 

could also be written in long-hand as 

car.x = car.x - 2. Then, on the next line and 
with the same indent as the first if statement, 
we can do the same for the right arrow; i.e., 

if keyboard.right: car.x += 2. These 

lines of code will move the car Actor left and right. 


>STEP-12 

The long and winding road 

Now that we have a car that we can steer, we 
need a track for it to drive on. We are going to 
build our track out of Actors, one row at a time. 
We will need to make some lists to keep track of 
the Actors we create. To create our lists, we can 
write the following near the top of our program: 
trackLeft = [] (note the square brackets) and 
then, on the next line, trackRight = []. This 
creates two empty lists: one to hold the data about 
the left side of the track, and one to hold the data 
about the right-hand side. 
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GET STARTED WITH PYGAME ZERO 


Tutorial 


figuree.py 


Q1 


Q2. 
Q3. 
Q4. 
Qs. 

>STEP-13 


Building the track 


We will need to set up a few more variables 


def makeTrack(): 
global trackCount, trackLeft, trackRight, 
trackPosition, trackWidth 
trackLeft.append(Actor("barrier", pos = 
(trackPosition-trackWidth, @) ) ) 
trackRight.append(Actor("barrier", pos = 
(trackPosition+trackWidth, @) ) ) 
trackCount += 1 


Figure 2 

The makeTrack() 
function. This 
creates two new 


; Actors with the 
for the track. After your two lists, declare the barrier image 
following variables: trackCount = @and then ane 
trackPosition = 25@, then trackWidth = 120, 
and finally trackDirection = false. Then let’s 
make a new function called makeTrack(). Define 
this function after your update() function. See 
the figure2.py listing for the code to put inside 
makeTrack(). The function will add one track Actor 
on the left and one on the right, both using the image 
barrier.png. Each time we call this function, it will 
add a section of track at the top of the screen. 
>STEP-14 pce ha 


On the move 

The next thing that we need to do is to move the 
sections of track down the screen towards the car. 
Let’s write a new function called updateTrack(). We 
will call this function in our update() function after 


function. Notice 
the constant 

SPEED — we need 
to define this at the 
top of our program, 
perhaps starting 
with the value 4 


figured. py 


Ole, 


2. 


03. 
04. 
O05. 
06. 
07. 
08. 
09. 
10. 
i 


Ze 


3e, 


14. 


def updateTrack(): 
blocks appear 
global trackCount, trackPosition, trackDirection, 
trackWidth 
b= 0 
while b < len(trackLeft): 
trackLeft[b].y += SPEED 
trackRight[b].y += SPEED 


# Function to update where the track 


b += 1 
if trackLeft[len(trackLeft)-1].y > 32: 
if trackDirection == False: trackPosition += 16 
if trackDirection == True: trackPosition -= 16 
if randint(®, 4) == 1: trackDirection = not 
trackDirection 


if trackPosition > 700-trackWidth: 
trackDirection = True 

if trackPosition < trackWidth: trackDirection = 
False 

makeTrack() 
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# Function to make a new section of track 


Tutorial STEP BY STEP 


CHANGING 
THE TRACK 
WIDTH 


The race 

car with barriers 
making up a track 
to stay within. The 
track pieces are 
created by random 
numbers so each 
play is different 


The 

draw() function 
and the update() 
function with 
conditions (if 
statements) 

to do different 
things depending 
on the value of 
gameStatus 


we do the keyboard checks. See the figure3.py 

listing for the code for our updateTrack() 

function. In this function we are using randint(). 
This is a function that we must load from an 

external module, so at the top of our code we write 
from random import randint. We use this function 
to make the track curve backwards and forwards. 


OZ, 
G3. 
04. 
OS. 
06. 
07. 
038. 
09. 
On 
(Ee 
i. 
lei 
14. 
iS: 
16. 
7. 
18. 
ioe 
20 
ZAG 
27 
Zo 


56 


figur 


py 


(): # Pygame Zero draw function 
global gameStatus 
screen. fi11((128, 128, 128)) 
if gameStatus == 
car.draw() 
b= 20 
while b < len(trackLeft): 
trackLeft[b].draw() 
trackRight[b].draw() 
b += 1 
if gameStatus == 
# Red Flag 


def 


if gameStatus == 
# Chequered Flag 


def (): # Pygame Zero update function 
global gameStatus , trackCount 
if gameStatus == 
if keyboard.left: car.x -= 2 
if keyboard.right: car.x += 2 
updateTrack() 
if trackCount > 200: gameStatus = 2 # Chequered 
flag state 


MagPi July 2018 


Making more track 

Notice at the bottom of the updateTrack() function, 
there is a call to our makeTrack() function. This 
means that for each update when the track sections 
move down, a new track section is created at the top 
of the screen. We will need to start this process off, 
So we will put a call to makeTrack() at the bottom 
of our code. If we run our code at the moment, we 
Should see a track snaking down towards the car. 
The only problem is that we can move the car over 
the track barriers and we want to keep the car inside 
them with some collision detection. 


A bit of a car crash 

We need to make sure that our car doesn’t touch the 
track Actors. As we are looking through the existing 
barrier Actors in our updateTrack() function, we 
may as well test for collisions at the same time. We 
can write if car.colliderect(trackLeft[b]) or 
car.colliderect(trackRight[b]): and then, 
indented on the next line, gameStatus = 1. We have 
not covered gameStatus yet — we are going to use this 
variable to show if the game is running, the car has 
crashed, or we have reached the end of the race. Define 
your gameStatus variable near the top of the program 
as gameStatus = @. You will also need to add it to the 
elobal variables in the updateTrack() function. 


Changing state 

In this game we will have three different states to the 
game stored in our variable gameStatus. The first or 
default state will be that the game is running and will 
be represented by the number oO. The next state will 
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Below Each of the barrier blocks is checked against the car to 
detect collisions. If the car hits a barrier, the red flag graphic 
is displayed 


be set if the car crashes, which will be the number 1. 
The third state will be if we have finished the race, 
which we’1l set as the number 2 in gameStatus. We 
will need to reorganise our draw() function and our 
update() function to respond to the gameStatus 
variable. See the figure4. py listing for how we do that. 


>STEP-18 

Finishing touches 

All we need to do now is to display something if 
gameStatus is set to1 or 2. If gameStatus is 1 then 
it means that the car has crashed and we should 
display a red flag. We can do that with the code: 


GET STARTED WITH PYGAME ZERO 


screen.blit('rflag', (318, 268)).Tosee ifthe 


car has reached the finish, we should count how many 


track sections have been created and then perhaps 
when we get to 200, set gameStatus to 2. We can do 
this in the update() function as in Figure 4. Then, 
in the draw() function, if the gameStatus is 2, then 
we can write screen.blit('cflag', (318, 268)). 
Have a look at the full code listing to see how this all 
fits together. 


>STEP-19 

Did you win? 

If you didn’t get the program working first time, 
you are not alone — it’s quite rare to have everything 
exactly right first time. Check that you have written 
all the variables and functions correctly and that 
the capital letters are in the right places. Python 
also insists on having code properly formatted with 
indents. When it’s all in place, test your program 

as before and you should have a racing game witha 
chequered flag at the end! 


Tutorial 


The next thing that we need 
to do 1s to move the sections 
of track down the screen 


CHANGING 
THE SPEED 


If you want 
to make the 
track move 


faster or 
slower, try 
changing 
the value of 
SPEED at the 
start of the 


program. 
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https:/ pygame-zero.readthedocs 10 


The official Pygame Zero 
documentation can be 


found at magpi.cc/fBqznh 
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Tutorial 


Raspbian 


1GB USB stick 


16GB microSD 


=" ON RASPBERRY PI 


Discover how to install and use Google’s TensorFlow framework 
to learn AI techniques and add AI to your future projects 


oogle TensorFlow is a powerful open-source deployment, where you take a model and use it as 
software framework used to power AI projects — part of a project. And that’s where the Raspberry 
around the globe. Pi fits in. 

TensorFlow is used for machine learning and the Although Raspberry Pi isn’t officially supported by 
creation of neural networks. These make it possible Google, there are example models included for the 
for computers to perform increasingly complex tasks, Raspberry Pi and it can be fun (if a bit hacky) to get 
such as image recognition and text analysis. TensorFlow up and running on a Pi. And there are lots 

When it comes to AI, most people think of powerful of interesting community projects around that put 
supercomputers crunching billions of numbers TensorFlow to good use. 
in giant databanks. But there are two parts to Using TensorFlow can give you a good 
machine learning. There is a train/test part, where understanding of how AI works, and how to put Al 
you use a lot of data to build a model. And there’s to practical use in your projects. 


3) i be &) Eiicicraspberypi: ~ (@’aneural Network Pla... $ TL @ |e 1732 
A Neural Network Playground - Chromium | x 

TensorFlow Playgrounds is a website This model is being used to fit blue 
that visualises deep neural networks. re aa eRe REAR a aanmaeneEa and orange dots in an image. The 
It's a good place to visit to understand more complex the layout of dots, the 
some of the underlying concepts of more layers the network needs (along 
artificial intelligence . with better activation functions). 

er With a Neural Network Right Here in Your Brow; | TensorFlow Playgrounds helps you 
understand these concepts 


Dont Worry, You Cant Break It. We Promise 


Epoch Learnir tivat } Zi Regularization rate Problem type 
000,071 0.03 - Tanh - None - 0 - Classification 


DATA FEATURES + — 2 HIDDENLAYERS OUTPUT 
Which dataset ck Which properties d Test loss 0.025 ~\ 
OU Wal IU you war (oO teed Ww a = + <= Training loss 0.021 a 
4 neurons 2 neurons 
Nd 
-O 7 
- 
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USE TENSORFLOW ON RASPBERRY PI 


hello_tensorflow.py 


import tensorflow as tf 
hello = tf.constant('Hello, TensorFlow! ' ) 


>STEP-O1 
Install TensorFlow with pip 


TensorFlow can be incredibly easy to installona 
Raspberry Pi, or something of a nightmare. It depends 


>PYTHON 


DOWNLOAD: 
magpi.cc/HuGfDm 


on the current build and which version of Raspbian 
OS you are running. Installation is often troublesome, 
but we’ve had recent success with building it directly 
using pip. Open a Terminal window and enter: 


sudo apt-get update && sudo apt-get upgrade 
sudo apt-get install python3-pip python3-dev 
pip3 install tensorflow 


>STEP-02 
Build from wheel 


If pip doesn’t work, you can try to build TensorFlow 
using the wheel file. In a Terminal, enter: 


sudo pip3 install --upgrade https:// 
storage. googleapis.com/tensorflow/1linux/cpu/ 
tensorflow-1.8.0-cp34-cp34m-1linux_x86_64.whl 


Alternatively, you can use a nightly wheel built for 
Raspberry Pi, which is available from magpi.cc/xKLBzu. 
Download the wheel file and run it, like this: 


sudo pip3 install --upgrade tensorflow- 
1.9.0rc@-cp34-none-linux_armv71.whl 


Take a look at TensorFlow’s Install Sources page 
(magpi.cc/yIpbCX) or Common Installation Problems 
page (magpi.cc/EHocyYB). 


>STEP-03 

Build from source 

If pip fails, you could always build TensorFlow from 
source; Sam Abrahams has written detailed instructions 
on doing so (magpi.cc/oCYtme). You will need a spare 
USB stick (1GB or higher) to extend the amount of swap 
Space on your Raspberry Pi and be sure to follow the 
instructions carefully. It takes around six hours to build, 
but we have gone through the steps and they do work. 


>STEP-04 


Hello TensorFlow 


Hopefully, you now have TensorFlow up and running. 


So let’s start it up. Open Python 3 (IDLE) using Menu 
> Programming > Python 3 (IDLE). Choose File > New 
File and enter the hello_tensorflow.py code. 

Save the code file as hello_tensorflow.py and 
Choose Run > Run Module. You will get a warning 
because TensorFlow is compiled for Python 3.4 and 
we’re running Python 3.5. Don’t worry, the code 
works. The Python shell will display: 


"Hello TensorFlow' 
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sess = tf.Session() 
print(sess.run(hello) ) 


8S OO OB ® © Bioiaesptempi ial 4 Python 2.7.13 Shell 
Pyth She - € 


an 3712 Chai 


3 hello_tensorfiow. py . 


7 7 
Ele Edt Shell Debug Options window Help Efe Edm Format Bun Options window Help 
[ 12 ‘ it 4 2017 imp rt sorfl C as ef 


Python 2.7.13 (default, Nov 24 2017, 17:33:09) : tensorflow as t 
[GCC 6.3.0 20170516) on linux2 hello = tf.const ' 
Type “copyright™, “credits” 


Simple variables, like strings, are stored inside objects known as 


‘Tensors’. These are only accessed via a session, which makes 
even a simple Hello World program more complex than usual 


>STEP-05 

Pi examples 

Google has a bunch of models developed for 
Raspberry Pi that you can test out. Start by cloning 
the TensorFlow repository: 


git clone https://github.com/tensorflow/ 
tensorflow. git 


Follow the instructions from on the page at 
magpi.cc/BrsbKi to build the example models. 

Now head to the part of the TensorFlow repository 
at magpi.cc/sGOzbr to find Google example models 
and instructions. 

The default example is a picture of Grace Hopper. 
Run it and you will see that it identifies a ‘military 
uniform’, ‘suit’, and ‘academic gown’ (and then other 
items in order of decreasing probability). From here 
you can see how this model could be used to identify 
objects in your own images, and use that in your own 
code. There is also a link to an example that uses the 
Pi Camera Module directly: magpi.cc/xGurWt. 


>STEP-06 

Community TensorFlow 

Now you have everything you need to start using 
TensorFlow. It’s a big subject and there’s far more 
to it than we could outline in this tutorial (or even 
this entire magazine). Learn by doing and follow 
some TensorFlow projects. Start with Sarthak Jain’s 
‘How to easily detect objects with deep learning on 
Raspberry Pi’ (magpi.cc/DFFAYt) or Alasdair Allan’s 
‘Magic mirror with TensorFlow’ (magpi.cc/YGtrOB). 
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SIGN UP FOR 
THIS UDEMY 
COURSE 


If you want 

to learn 
TensorFlow in 
depth, or are 
finding the 
‘TensorFlow 
without a 
PhD' course 
limiting, then 
sign up for 

a course. 
There are lots 
of different 
courses out 
there, and 
we've trieda 
lot of them. 
Jose Portilla 
is the Head of 
Data Science 
at Pierian 
Data and his 
Udemy course 
‘Complete 
Guide to 
TensorFlow’ 
(magpi.cc/ 
VIJUtKJ) is 

the best 
TensorFlow 
course we 
have found. 
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CODING GAMES 


ON THE RASPBERRY PI 


IN C/C++ B&ay 


Code::Blocks 
sudo apt-get 
codeblocks 


stb_image.h 


KEEP 
ASSETS TIDY 


At the moment 
we're not really 


doing that other 
than keeping 
them in a folder. 
We'll discuss 
this soon. 
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Animate a character and start making a platform game 


e’ve gone as far as we can with the basic 
bat-and-ball game, so it’s time to introduce 
another stalwart of the 2D era and create a 
simple platform game -— this time with a character we 
can control, who can walk, jump, and climb, to avoid 
some fairly unintelligent baddies. 


Animation 101 

What is animation? It might seem obvious, but why 
is it that cartoons and movies allow us to see multiple 
individual frames as smooth(ish) motion? 

All screen-based visuals are based on a simple concept 
called image retention, where we trick the brain into 
thinking that a sequence of rapidly changing frames 
(each not massively different from the previous one) 
appear to be in motion. As long as we can keep the frame 
rate up, these individual still frames will seem to move 
smoothly; our brain will fill in the missing frames. 

The rate of animation can be quite variable, but 
most people start to see ‘jerkiness’ if an animation 
is less than 15-20 fps (frames per second). Individual 
perception limits vary quite a bit from person to 
person. Cartoons and movies mostly rely on 24 fps, 
but there are a few people who see that as jerky. We 
will generally set a 20 or 30 fps rate on animation, 
even if the game is updating at 6o fps. 

Like traditional cartoons, all computer graphics, 
even 3D, rely on there being enough frames to give the 
impression of the motion you want to represent over a 
sensible time for that motion to occur. You can make a 
character walk with just two images changing every 30 
frames, but it looks better with four changing every 15, 
and better still with eight every seven or eight frames. 


GRRE 


Frame 0 - 3 of a right facing walk 
Frame 0 can also be a stand 


we & 


Frame 0-3 of a Climb frame 


Figure 1 Simple individual frames 


The more images for the sequence you have, the 
smoother the animation, but you are eating up your 
memory by storing so many individual sprite images. 
So a balance must be found. 

Figure 1 shows two simple four-frame animations. 
Since we’re only going to use a few frames for walking, 
we could cheat and reuse them for walking, standing, 
falling, and jumping, though at the moment we do 
need left- and right-facing. Each of these different 
actions we will call a ‘state’, but each state needs to 
keep track of what sequence of animation it is doing 
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and how the control system will change depending on 


the state. For example, we can’t really jump or climb if 


we are currently falling. 

Separating the actions of our character into states 
means we can focus on the control that is relevant to 
that state and, where needed, signal a change in state 
— from walking to jumping, for example. 

By defining each action as a state, we are making 
our first attempts at a state machine, where different 
code is called depending on the setting of that stage. 
That code can also change the state, allowing us to 
switch back and forward between states depending on 
whatever conditions we want to test. A good example 
might be when falling: we are only going to test to see 
if we should stop falling, and if we find ground under 
our feet, we switch into a standing frame, or perhaps 
even a duck-and-roll landing sequence state. Ora 
splatting into a bloody mess state if we are feeling a 
bit nasty and our hero fell a long way. Sadly, we don’t 
really have enough graphics to let our imagination 
loose just yet. 

Simple state management can be done with 
sequences of if-then-else conditions, but C/C++ gives 
us a much neater concept called a switch, which calls 
different code based on different ‘case’ statements. 
Refer to Figure 2. 

Generally speaking, being able to keep the code for 
a specific state lets us focus on only dealing with the 
conditions that relate to that state. For example, when 
walking, we do not need to worry about jumping code, 
but we do need to test if we should be falling down. 
Our code becomes more about managing the state we 
are in at given points than trying to work out which of 
the five or six different abilities we give our character. 
This allows for expansion of ability and isolation of 
the code to provide those abilities. 


Using maps 
Our bat-and-ball game touched on the concept of 
maps, Since our screen was basically made up of an 
array which we interacted with. That array was a map, 
where each cell related to a specific tile on screen. 
But platform games take the concept of amap toa 
new level. Consider how many levels you can have in 
a game like Super Mario Bros; all these levels use the 
same quite limited and basic tile set, yet clearly there 
are thousands of cells making up each map. A cell in 
a map, however, can be represented by a single byte 
(though more typically a 32-bit integer) and allow 
us to have arrays of any size to represent quite huge 
numbers of levels. 

What’s more, those levels can be larger than the 
screen size, and by simply moving a screen view 
area — under the control of the principal character in 
Our game — we can create scrolling. The view screen 
area moves as we want it to, but generally under the 
control of our principal character who drags the view 
along. We’ll tackle that next time. 
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typedef enum { // we define the names of our states like this 
STANDING = @, 
WALKING, 
JUMPING, 
CLIMBING, 
FALLING, 
DROWNING 


} StateVaues; 
void Bob: :BobsLogic() 


switch (CurrentState) // the Switch asks what is our current state represented as an enumerated value or int 
f 


case STANDING: 
//Do code for a standing character 
break; // this ends the code 

case WALKING: 
break; // 

case JUMPING: 
//O00 code for a jumping character 
break; // this ends the code 

case CLIMBING: 
//De code for a climbing character 
break; // this ends the code 

case FALLING : 
//O00 code for a falling character 
break; // this ends the code 


notice we must end each section with break...if we don’t it falls through 


case DROWNING : 
//De code for a drowingcharacter 
break; // this ends the code 
default : // this is a special case in case we have not found code for a particular state value 
{/do default code, which usually means we have forgotton something 
break; 
} // clese the switch 


Figure 2 How a switch keeps states separated 


We’ll start with a single screen map for now, 
which is called Map2 in the code. As you can see 
in Figure 3 over the page, this is a fairly simple 
platform game layout, but drawn the exact same 
way as our bat/ball map, which does create some 
issues we will discuss soon. 

Remember that our characters do not interact 
directly with the screen: our screen only gives us 
a visual interpretation of what happens during 
the map interaction. So as long as we Keep our 
code focused on the characters’ interaction with 
the map, we can move our screen around any way 
we want. 
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cpp 
SimpleObj.h/cpp 


Game.h/cpp 
OGL.h/cpp 
BallLh/cpp 
NewBall.h/cpp 
Paddle.h/cpp 
Input.h/cpp 


DOWNLOAD: 
magpi.cc/ YUdxXy 


Our main character 

Our new character is called Bob. The Bob class inherits 
from our simple objects and, like our previous balls, 
has some information on graphics and position which 
lets us draw him. Take a moment to review the code 
and the comments that explain what it’s doing. 

Bob’s class is a little like our old Bat class: Bob is 
the only one who cares about the keys, so he’s going 
to read the keys, move around, jump, and test if he’s 
standing on something; if not, he’s going to obey the 
laws of gravity and fall, though we won’t splat him if 
he falls too far. 

Gravity in game worlds acts very similarly to gravity 
in the real world: it’s always there and pulling you 
down, but as long as there’s ground beneath us we 
don’t fall through. So we need to test if there’s ground 
under our feet during our normal, non-gravity- 
defying states. 

Gravity is usually represented as a speed in platform 
games: O when on the ground and whatever amount we 
find works best when not on the ground. To jump, we 


KEEP CODE 
READABLE 


Comments 


are great, but 
readable, self- 
descriptive 
code is better. 
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6 oe s)) * 98 > Fer ~ 


Figure 3 
A nice new map! 


STATE 


MANAGEMENT 


MAKES LIFE 
EASY 


Keep your 
states well 
defined and 
separate, 

and focus on 
making each 
state work 
before starting 
another. 


LEARN 


MORE 
ABOUT C 


Brian has a 
whole book 
on the subject 
of making 
games C and 
C++, called The 
Fundamentals 
of C/C++ Game 
Programming: 
Using 
Target-based 
Development 
on SBCs. Grab 
it here: 
magpi.cc/ 
nUkjEt 


the Row variable to go down the grid 


and will go slemg the grid 


td 2a — 


simply give ourselves an upward speed and when gravity 
is in effect, we deduct it from the character’s current 
speed, creating a reduction in his upward motion until it 
eventually goes negative, causing him to fall. 

By adding a Speed value to the co-ordinates of our 
character, we can get much smoother — and, later, 
timed — movement in our characters. We can also 
use this speed concept for left and right motion, 
using friction to reduce it. The source code for Bob’s 
movement shows this principle for both vertical and 
horizontal movement. 


What am | standing on? 

Testing the tile relies on us knowing the reference 
point of Bob. Usually that’s the centre of the sprite, 

so a simple offset of half his height will get our testing 
point to be at his feet. In fact, we should add an extra 
one pixel, since we want to test what’s just below 

his feet. Also, since our sprite is wider than a tile, we 
should really test a few points to make sure that if any 
part of the main graphics that make up the sprite are 
on a ground tile, we prevent the fall. 

Now we have gravity, jumping is a simple case of 
giving him an upward speed that initially overcomes 
the force of gravity, but which is constantly reduced 
by gravity. With the result that what goes up, must 
come down, until it lands on a ground tile. 

Jumping and climbing both start by pressing the Up 
key, so clearly a decision needs to be made when Up 
is pressed to determine if we climb or jump, and that 
will depend on our test of whether we are on a ladder 


How many ground tiles do we have, and how can we test? 


Oe 
x \S OF Ground =1 
7, He FO ROG RMNG Ladder =2 


BC's 
(sing Target-based Development ond 
si oe 


ne in Binary bit 0 = Ground 


in Binary bit 1 = Ladder 


Tile 1 has attribute 00000000000000000000000000000001 
Tile 2,3,4,7,8,9,10,11, 15 are the same 


Tile 14 has attribute 00000000000000000000000000000011 
wan. Because its both ground and ladder! 

, ea Ae 
Brian Bevken 


Figure 4 Encoding tile attributes into bit fields 
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or not. In order to climb a ladder, we must know which 
tile represents the ladder, in this case tile number 14. 

Now, that is fine — we can test for our offset in the 
array to see if it has hit that tile number and if the 
correct up/down keys are pressed when were are over 
or above a ladder, we can change state to climb — but 
what if we have more than one ladder type? (We don’t. 
But... what if we did) 


That's a lot of ifs 


Our map is fairly simple, but we’re already considering 
testing for two or three different concepts of what 
makes a ground tile we can stand on. At the moment, 
tile numbers 1, 2, 3, 4, 7, 8, 9, 10, and 11 appear to be 
types of ground. Our ladder, 14, is also in some ways a 
eround tile — so is a brick tile, so is a girder tile, so is 

a grass tile, etc. So we need to consider if sequentially 
testing tiles with a whole bunch of if statements is a 
wise move. 

Well no, of course it’s not, for all sorts of reasons. 

It is hard to manage when we add new tiles and it also 
makes the code test for the last tile in the list slower 
than the code test for the first. 

A better idea is to consider that each tile has certain 
attributes, which we can encode into bit fields. Bits 
are the basic binary (on/off) components that make 
up all our data values, and it’s possible to set and test 
individual bits (Figure 4). We don’t need to be able to 
count in binary to use it; we just need to know that the 
bits are usable and very useful. In an int we have 32 
bits, so we can store 32 on/off attributes. 

Our simple game only really needs two concepts at 
the moment — Ground and Ladder — but we could later 
consider Metal and Brick as an attribute and trigger 
different types of walking sound effect. 

Because we can use bit fields to define an attribute, 
we can in theory have 32 different attributes assigned 
to every tile, and that means that tiles which serve the 
Same purpose but have different tile numbers can be 
treated the same in code. 

The main difference from our viewpoint is that 
instead of testing for a tile number, we use that tile 
number to look up the attributes for that tile and test 
the attribute. 


Next time 
This is all so far so good, but clearly there’s a massive 
issue: the speed of our game has fallen to unplayable 
levels! Do we know why? The source code has a #define 
called FastUpdate — try setting it to true and see what 
a difference it makes. 

Next lesson we’ |l examine how to do scrolling, add 
some baddies, and also make more improvements 
to our updating to explain and further improve the 
performance of the tile draws. Sadly, there wasn’t 
space this month to discuss text/font systems, so we’ll 
try to fit that in next time to make score display and 
menu/instruction screens much simpler. 
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JODY CARTER 


Jody is a primary school teacher and 
computing leader for a MAT. He is 
grateful for the Raspberry Pi camera as it 
saves him from having to stand outside 
in the rain to take bad pictures of wildlife. 
twitter.com/codeyjody 


BUILD A WILDLIFE 
CAMERA TRAP WITH 


Youll 
Need 


> Pi Camera 
Module 
magpi.cc/ 
camera 


> Pi NolIR Camera 


Module (optional) 


magpi.cc/ 
ircamera 


> ZeroCam 
NightVision 
(optional) 
magpi.cc/ 
qqXcLK 


> Waterproof 
container (like 
a jam jar) 


> Blu Tack, Sugru, 
elastic bands, 
carabiners 


> ZeroView 
(optional) 
magpi.cc/ 
2ze89hWt 


Uncover the goings-on in your garden, pond, or school playground 
when no one’s looking with this easy-to-use Raspberry Pi camera trap 


ver wondered what lurks at the bottom of 

your garden at night, or which furry friends 

are visiting the school playground once all the 
children have gone home? 

Using a Raspberry Pi and camera, along with 
Google’s Vision API, is a cheap but effective way to 
capture some excellent close-ups of foxes, birds, 
mice, squirrels and badgers, and to tweet the results. 

Using Google’s Vision API makes it really easy to get 
Al to classify our own images. We’II install and set up 
some motion detection, link to our Vision API, and then 


tweet the picture if there’s a bird in it. It’s assumed you 

are using a new Raspbian installation on your Raspberry 
Pi and you have your Pi camera set up (whichever model 
you’re using). You will also need a Twitter account anda 
Google account to set up the APIs. 


Motion detection with Pi-timolo 

There are many different motion-detection libraries 
available, but Pi-timolo was chosen as it is easy to edit 
the Python source code. To install, open a Terminal 
window and enter: 


Position the camera 
low and ensure it’s 
tight up against any 
glass or plastic 


Get a decent power 
bank that will last for 
at least seven or eight 
hours overnight 
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Use sealable containers 
and jars and make sure 
they're watertight 
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{isting 2 cil 2 


Q1. # search for userMotionCodeHere. 

Q@2. # There will be 2 results, rion delectian 

Q@3. # edit the second so you are passing code.py 
filename to the function 

Q4. userMotionCodeHere( filename) 

@5. 

@6. # make sure you include filename as a 
parameter in the function 

Q@7. def userMotionCodeHere( filename): 


DOWNLOAD: 
magpi.cc/qoRuSW 


8. # we need to create an instance of the Google Vision API 
e9. client = storage.Client() 
10. # instantiates a client 
fee Ness Our MnerapHngwalcy 11. client = vision. ImageAnnotatorClient() 
ned 
cd ~ dee # loads the image into memory 
wget https://raw. github. com/pageauc/pi- dA; with io.open(filename, ‘rb') as image file: 
timolo/master/source/pi-timolo-install.sh 15. content = image_file.read() 
chmod +x pi-timolo-install.sh a 
./pi-timolo-install.sh a image = types. Image(content=content ) 
aS 
Once installed, test it by typing incd ~/pi-timolo a Pepe LCnils panes ger ee irene en ge moe lees 
a. 20. response = client.label_ detection(image=image ) 
and then ./pi-timolo.py to run the Python script. 
pail # pass the response into a variable 
At this point, you should be alerted to any errors such a labals — peananes. Tehel_anneteciore 
as the camera not being installed correctly, otherwise 53. 
the script will run and you should see debug info in 24. # we have our labels, now create a string to add to the text 
the Terminal window. Check the pictures by waving ANSE # for debugging - let’s see what Google thinks is in the image 
your hand in front of the camera, then looking in 6. print('Labels:') 
Pi-timolo > Media Recent > Motion. You may need to 97. # add labels to our tweet text 
change the image size and orientation of the camera; 28. tweetText = "Labels: " 
in the Terminal window, enter nano config.py on animalInPic = False 
and edit these variables: imageWidth, imageHeight, 30. for label in labels: 
and imageRotation. cule print(label.description) 
While we’re here, if you get a lot of false positives, 32. tweetText = tweetText + " " + label.description 
try changing the motionTrackMinArea and 33. # edit this line to change the animal you want to detect 
motionTrackTrigLen variables and experiment with eae if “bird” in tweetText: animalInPic = true 
the values by increasing to reduce sensitivity. See 2/5) 
the Pi-timolo GitHub repo (magpi.cc/PFqFSJ) for 36. # set up Tweepy 
more details. 37. # consumer keys and access tokens, used for authorisation 
There’s also going to be some editing of the 38. consumer_key = *XXX* 
pi-timolo.py file, so don’t close the Terminal window. 39. consumer_secret = "XXX" 
Code needs to be added to import some Python 40. HEESSS UENEM  aS 
libraries (Listing 1), and also added to the function uh pS A TN eS 
userMotionCodeHere() to check with the Vision te: 
43. # authorisation process, using the keys and tokens 
M4, auth = tweepy.OAuthHandler(consumer_key, consumer_secret) 
. . AS. auth.set access token(access token, access token secret) 
{isting I 6 
AG. # creation of the actual interface, using authentication 
Ag. api = tweepy.API(auth) 
Q1. # add this in at the very top, under 49. 
| print(’Loading ....') along with the other 50. # send the tweet with photo and message 
| libraries imported 51. photo path = filename 
@2. import io So) # only send tweet if it contains a desired animal 
| Q@3. import tweepy sey if animalInPic: 
: Q@4. from google.cloud import vision 54. api.update with_media(photo path, status=tweetText) 
| Q@5. from google.cloud.vision import types siete 
Q6. from google.cloud import storage 56. return 
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Get great 


photos with night- 
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vision cameras 


WALKTHROUGH 


API before tweeting (Listing 2). We can do this now in 
preparation of setting up our Google and Twitter API. 
You should still be in the Pi-timolo folder, so type nano 
pi-timolo. py and add the imports at the top of the 
file. Next, press CTRL+W to use the search option to 
find the UserMotionCodeHere() function and where 


We will be using Google Label 
Detection, which returns a list 
it associates with the image 
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it’s called from. Add the new code into the function 
(line 240), before the return line. Also locate where 
the function is being called from (line 1798), to pass the 
image file name and path. Press CTRL+X then Y and 
RETURN to save. Next, we’ll set up the APIs. 


Animal detection and tweeting 

We will be using Google Label Detection, which 
returns a list it associates with the image. First off, 
you will need to install the Google Cloud Vision 
libraries on your Raspberry Pi, so type pip install 
--upgrade google-cloud-vision into your 
Terminal window. Once finished, run pip install 
google-cloud-storage. 

Now you need authorisation, by going to 
magpi.cc/xVLSVa to set up an account. Click on the 
Manage Resources link and create a new project (you 
may need to log in or create a Google account). Go 
to the API Dashboard and search for and enable the 


Vision PI. Then go to API & Services > Credentials, 
click on Create Credentials > Service Account Key 

> New Service Account from the drop-down. Don’t 
worry about choosing a Role. Click Create and you’ 11 
be prompted to download a JSON file. You need this 
as it contains your service account key to allow you to 
make calls to the API locally. Rename and move the 
JSON file into your Pi-timolo folder and make a note 
of the file path. Next, go back to pi-timolo.py and 
add the line: os.environ["GOOGLE_APPLICATION __ 
CREDENTIALS"] = "path_to_your_.json_ 
credential file" belowimport os to reference the 
credentials in your JSON file. 

Finally, set up a Twitter account if you haven’t 
already and install Tweepy by entering sudo pip 
install tweepy into a Terminal window. Once set 
up, visit apps.twitter.com and create a new app, 
then click on Keys and Access Tokens. Edit the code 
in userMotionCodeHere() with your own consumer 
and access info, labelled as ‘XXX’ in the code listing. 
Finally, place your camera in front of your bird feeder 
and run ./pi-timolo.py. Any pictures taken of a 
bird should now be tweeted! If you want to identify 
a different animal, change the line if "bird" in 
tweetText: animalInPic = true. 

Please note that although the API works well, it 
can’t always discern exactly what’s in the picture, 
especially if partially in view. It also won’t distinguish 
between types of bird, but you should have more 
success with mammals. You can test the API out with 
some of your pictures at magpi.cc/EBzDam and visit 
twitter.com/pibirdbrain to see example tweets. Good 
luck and happy tweeting! 
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CoderDojo 


Canlstarta 
CoderDojo club 
in my local area? 


CoderDojo is a global network of free, volunteer-led, project-based 
programming clubs for children aged 7-17. Dojos are championed by 
individuals all around the world who are passionate about giving young 

people the opportunity to learn to code. 


Incredibly 
rewarding experience 


“| started a Dojo to give my kids a place to meet other children also 
interested in programming and making games. | get to see them 
making new friends, learning from one other, and they loved it. 
Realising how | had created such a wonderful place for children has 
ignited a spark in me.’ 

- Maroes, CoderDojo NL 


Start your own club. Join us at CoderDojo.com 


The CoderDojo Foundation is Irish Registered Charity (524255) CHY20812 . 
and Is part of the Raspberry Pi Foundation, UK registered charity 1129409 eae eS Raspberry PI 


YOUR QUESTIONS ANSWERED 


FREQUENTLY 
ASKED QUESTIONS 


NEED A 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


Your technical hardware and software problems solved... 


LEARNING 
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RESOURCES 


Official projects site 

Part of the Raspberry Pi Foundation’s mission 

is to make sure there are plenty of free learning 
resources for students and educators to make use 

of, and you can find a huge range of guides on 
projects.raspberrypi.org. Many have been translated 
into a variety of languages as well! 


Raspberry Pi Forum 

The forum is the number one place to go if you’re 
having trouble with a project. There’s a wealth of 
information there which you can find with the search 
bar, and an active community that will try to help you 
with your problem: raspberrypi.org/forums. 


Raspberry Pi Press 

The MagP1 is published by the Raspberry Pi Press 
(store.rpipress.cc), and everything made there 
is available for free as a PDF. While it’s not all 
specifically aimed towards education like our 
Beginner’s Book, there are a lot of guides and 
inspirational projects that will help you on your 
Raspberry Pi journey. 


Picademy 

The Raspberry Pi Foundation provides free teacher 
training via the Picademy scheme, currently in the 
UK and USA. At these two-day events, teachers and 
educators can learn everything they need to know 
about using the Raspberry Pi and using it to teach kids 
about computing and digital making. Find out more 
here: magpi.cc/2Bakf96. 


After-school clubs 

Code Club (codeclub.org.uk) and CoderDojo 
(coderdojo.com) are networks of weekend and 
after-school clubs that are part of the Raspberry 
Pi Foundation. They offer free resources for kids 
to learn about computing, which are used around 
the world. 


Hello World 

The magazine for 
educators is available 
as a free PDF and you 
can also get a print 
subscription of it for 
free. It includes lesson 
plans and features 
aimed towards 
teachers and other 
educators who are 
working in computer 
science fields: 
helloworld.cc. 


INSPIRING 


Adafruit 

These US-based makers specialise in components 
and add-ons for the Raspberry Pi, as well as awesome 
tutorials on how to make cool things. This includes 
handheld retro consoles, face-recognition locks, and 
so much more! Check them out here: adafruit.com. 


Hackster.io 

You can always find people sharing great Raspberry Pi 
tutorials on hackster.io (that’s the web address) from 
all around the world! Not all of them may be to your 
taste, but the team also do regular highlights of the 
best projects which you can use for inspiration. 


elementi4 

Farnell’s community side is a great way to see people’s 
building process, thanks to various competitions 
revolving around different challenges. You can even 
enter a challenge yourself to try to win something. 
Check it out here: magpi.cc/GrmbXe. 
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WHAT ARE THE DIMENSIONS 

OF THE RASPBERRY PI? 

The Raspberry Pi Model B versions measure 
85.60 x 56 x 21mm (roughly 3.37 « 2.21 « 0.83 
inches), with a little overlap for the microSD 
card and connectors which project over the 
edges. They weigh 45g. The Pi Zero and Pi 
Zero W measure 65 x 30 x 5.4mm (roughly 
2.56 x 1.18 x 0.20 inches) and weigh 9g. For 
the mechanical outline, please see the 
documentation: magpi.cc/xhPBSq. 


WHAT HARDWARE DOCUMENTATION 
IS AVAILABLE? 

All available documentation is in 

our documentation repository: 
magpi.cc/ujsAel. 


WHAT SOC ARE YOU USING? 
All models of Raspberry Pi use Broadcom 
SoCs, containing a VideoCore IV GPU but 
with various ARM CPU cores. 


Having trouble with The MagPi on the App Store or Google Play? 
Here are your most common questions answered. 


How do | find The MagPi on Google Play or the App Store? 
All you have to do is go to the search bar and type ‘The MagPi' 


or ‘Raspberry Pi' to find us. 


The original Raspberry Pi used a 
Broadcom BCM2835. This contains a 
single-core ARM1176JZFS with floating 
point, running at ZOOMHz, and a VideoCore 
IV GPU. The GPU is capable of Blu- 
ray-quality playback, using H.264 at 
4OMBps. It has a fast 3D core, accessed 
using the supplied OpenGL ES 2.0 and 
OpenVG libraries. 

The Pi 2 Model B originally used the 
Broadcom BCM2836. This contains a quad- 
core ARM Cortex-A7 processor with floating 
point and NEON, running at 90OMHz, and 
the same VideoCore IV GPU that is in the 
earlier models of Raspberry Pi. 

The Pi 3 Model B uses the Broadcom 
BCM2837, containing a quad-core ARM 
Cortex-A53 running at 1.2GHz. Its GPU 
capabilities are equivalent to the Pi 2. 
Newer Pi 2 boards now use the same SoC 
as the Pi 3, but downclocked to match the 
speed of the original Pi 2 SoC. 


OSCILLOSCOPE 


I've subscribed to the digital edition and I can't sign in 


to restore my purchases. Please help! 


Since your The MagPi purchases are linked to your Google or Apple 
accounts, there's no need to sign in at all. If you'd like to re-download 


your purchases on your current device, or make your purchases 
available on other devices, all you need to do is hit Menu on the home 
screen, then Restore Purchases on the sidebar. 


How can | search the digital magazine for keywords? 
Finding direct references is really easy with The MagPi app - 


all you have to do is tap the screen to get the app's GUI to show, 
and then press the small magnifying glass icon in the top-right a 


corner of the screen. Now, just type in your search term to find the 


relevant results. 
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The official Naspberry Pi 


MAKE YOUR OWN 


The new Pi 3 Model B+ uses the 
Broadcom BCM2837Bo, containing a quad- 
core ARM Cortex-A53 running at 1.4 GHz. 


WHAT IS A SOC? 

A system-on-a-chip (SoC) is a method of 
placing all necessary electronics for running 
a computer on a single chip. Instead of 
having an individual chip for the CPU, GPU, 
USB controller, RAM, etc., everything is 
compressed down into one tidy package. 


WHY DID YOU SELECT THE SOC? 
Cost and performance. 


HOW DOES IT BOOT? 

As standard, all the files necessary for 
booting are installed in a FAT32 partition 

of the microSD card. The latest firmware/ 
software, however, allows booting to be set 
up without a microSD card, for example from 
a USB stick or other mass storage device. 
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RUN ANDROID 
ON RASPBERRY PI 


» Use Android Apps » Build Touchscreen Devices. Control Electronics 


HERE COMES 
4 THE SUN 


Track the weather 
aa YS wen Raspperry Fi 


GET IT ON 


>> Google Play 


Available on the 


€ App Store 
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> Raspberry Pi with wireless connectivity 
(or a wireless dongle) 


> BME280 pressure, temperature, and 
humidity sensor magpi.cc /LFGBDk 


> DS18B20 digital thermal probe 
(with 1m lead) 


>2x47kQ resistors 


> Some 5mm-pitch PCB mount screw 
terminal blocks 


> A breadboard, some jumper wires 


> Anemometer, wind vane, and rain gauge 
magpi.cc/txkqdr 


> 2 x RJ11 breakout boards (optional) 


> MCP3008 analogue-to-digital converter 
integrated circuit magpi.cc/ BLH[Km 


> Weatherproof enclosures; 
recommended products are the IP55 
Thermoplastic 7 Entry Junction Box 
Enclosure (magpi.cc/myRZHW) and 
IP55 Thermoplastic 10 Entry Junction 
Box Enclosure (magpi.cc/uYvzUZ) 


\ 
\ 
\ 
. \ 
\ 
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BUILD YOUR WEATHER STATION TO MEASURE 
TEMPERATURE, HUMIDITY, AND ATMOSPHERIC 
PRESSURE, WIND AND RAINFALL. COME RAIN OR 
SHINE YOU'LL BE ABLE TO SEE WHAT'S COMING 


n 2016, Raspberry Pi sent out 
nearly 1000 Oracle Raspberry Pi 


Weather Stations to schools from 


around the world who had applied to 
receive these kits. 

The Weather Station kit enables a 
Raspberry Pi to collect weather data using 
a variety of sensors. These kits have been 
very popular. If you’re one of the many 
people who has been wanting to get hold 
of one, this guide will take you through 
the process of building your own. 

This is an advanced project, both in 
terms of electronics and programming. 
You can find the full project, with 
even more details, on the Raspberry Pi 
website: magpi.cc/SYWwma. 


If you get stuck while making this 
project, you can find help on the 
Raspberry Pi forums. There isa 
dedicated board for the Weather Station. 


NnaldDI1.c 


fien progect Muhe on betal Stame Geahoowrd tor eather carte 
Ph by wet > Thy New O2, 2097 4-50 


We ale: onteny mare! genie wom eves abe 


STIGEY Phrase Cham pow caperiemcns amd atvine here 
Th dy cites » med age 222 3 
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BUILD A WEATHER STATION 


SOFTWARE DOWNLOAD 


You’ll need the Oracle Raspberry Pi Weather Station 
software. You don’t need to install it, but you’ll use some 
of the Python programs. Clone the GitHub repository by 
opening a Terminal window and typing: 


You can find more information on this library at the 
Python Package Index (magpi.cc/dhSyei). 


And install the MariaDB database server software: 


git clone https://github.com/ 


: ‘ : sudo apt-get install -y mariadb-server mariadb- 
RaspberryPiFoundation/weather-station 


client libmariadbclient-dev 


Now install the BME28o0 Python library: 
sudo pip3 install mysqlclient 


sudo pip3 install RPi.bme280 


Le SATE Wee 
- bad : 4 = Ntee b 4 


The anemometer has 
three arms with Scoops 
on the end that Catch the 
wind and cause the arms 

to spin. This measures 
the wind Speed 


The wind vane et ae 
the direction the win 


is coming from 


A 3D-printable mount 
is used to secure the 
Raspberry Pi inside 
the Larger box 


The smaller box contai 

a BME280 intoniceoiana 
environmental sensor. 
This provides data on 

the humidity, Pressure 
and temperature 
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The BME280 sensor is a digital sensor 


that can measure temperature, 


humidity, and atmospheric pressure. 

It is available in a number of breakout 
boards from popular manufacturers such 
as Adafruit and SparkFun. This guide 
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Figure 1 How to 
wire up the sensors 
to the Raspberry Pi 


A bucket gathers water until i it 


dap , then tips out the water 


riggers a GPIO pin 
Ra taspberry Pi Pin on the 


Rainfall 


Wind Sensors 


daar bathe aaa a magnet) 
been it rotates with the els 


This is use 
connected = 


sed to tri 
GPIo pin onthe 
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assumes you have the Adafruit package 
(magpi.cc/IFGBDk), but the instructions 


Should be applicable to most versions. 
One thing t@acheck 1s that the 17 

address is correct: for the Adafruit 

models it is 0x77 (as shown in the 


LINSYSHLI 


DTT 
IWdH 
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TURN YOUR RASPBERRY 
PI INTO A HEAT AND 
HUMIDITY MACHINE 

USING A BME280 SENSOR 


bme280_sensor.py code), but other 
versions can have different addresses 
(Ox76 is acommon alternative, as shown 


in bme280_sensor_2.py). 


pins on th 


; shown 'in the table % 
| below, 7 The BME280 ig 
| pins on ere toto GPIO 


‘r breakout 


boa ards may pod Other 


CSB), 


(AVIdSI@) IS 
a EERSRSEEEEE 


| PiGPIO 


| 17 (3V3) 
6 (GND) | 
3 (SDA) 


(such 


but those are not 


eee rally gested 


Nas SDO or 


®.:; okeaee a! 


Teno pay 


BME280 
Vin 
GND 


_ SDA(SDI) 


Wires to DS18B20 
SSS as 


fritzing 
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In Raspbian, select Menu > Programming > 
Python 3 (IDLE). Create a new Python file, 

Save it as bme280_ sensor. py in the /home/p1/ 
weather-station directory and add the code 
from bme_280_sensor.py to it. 


STEP 2 


While the code is running, exhale onto the 
BME280 sensor. You should see the humidity 
value (and possibly the temperature) increase. 
Press CTRL+C to exit the program. 


cus 


Replace the 
function called 


loop witha 
that returns 


the humidity, pressure, and temperature 
readings, in that order. Update your code using 
bme_280_sensor_2.py as a guide. 


STEP A | 


The BME280 will report the air temperature, 
but this can be warmer than the ground, 
particularly if it’s frosty. A DS18B20 thermal 
probe (magpi.cc/JILuTd) stuck into the soil is 
a useful supplemental measurement. 


STEP 5 


Normally the DS18B20 comes with three bare 
wires, so the easiest way to test it is to use 

PCB mount screw terminal blocks that can be 
plugged into breadboards. Add your DS18B20 to 
your circuit as shown in Figure 1. 


STEP 6 


Open the file /boot/config.txt: 


Edit it by adding the line below at 
the bottom: 


raspberrypi.org/magpi 


The Adafruit BME280 |?C : (e) 
or SPI Temperature Humidity gp x3. 


Pressure Sensor ie he ag >> 
ee ; 
ve 
Then open /etc/modules: Qs x 
Q 
A 

Add the lines below at the bottom : vn <> 
of the file: _& S 2, 7 
Reboot the Raspberry Pi. 


Open the file /home/pi/weather-station/ 
dsi8b20_therm.py in IDLE and run it (see 
‘Software download’ box on page 71 to use 
Git to clone this file). You should see the 
temperature printed out in the Python 
Shell window. 


bme280_sensor.py 


Q@1. import bme28@ 

Q@2. import smbus2 

Q@3. from time import sleep 
Q4. 

05. port = 


may be different 
Q@7. bus = smbus2. 
Q8. 
Q9. ) - ns(bus, address) 
10. 
11. while True: 
ie bme280 data = bme28@. (bus, address) 
13. humidity = bme280 data.humidity 
14. pressure = bme28@ data.pressure 
Se ambient_temperature = bme28@ data.temperature 
16. (humidity, pressure, ambient_temperature) 
17. (1) 


(port) 


Q@6. address = 0x77 # Adafruit BME280 address. Other BME28@s 


- bme280_sensor_2.py 


import bme28@ 
import smbus2 
from time import sleep 


port = 1 
address = 0x76 


bus = smbus2. (port) 


(bus, address) 


read _all(): 


bme280@ data = bme. (bus, address) 


bme28@ data.temperature 


return bme28@ data.humidity, bme28@ data.pressure, 


July 2018 


So far, all the sensors you’ve 
used have been passive electronic 
sensors that just sit there and make 
measurements of their surroundings. 
However, to measure things like 
tainfall and wind speed/direction, 


you’ll need to use active mechanical 
devices that physically interact with 
the environment. 

The original Oracle Weather Station kit 
employed popular wind and rain sensors 
(magpi.cc/mkxjNE) that are used in 


YOU'VE DEALT WITH 
HEAT, NOW IT'S TIME 
TO TACKLE ANOTHER 
ELEMENT: AIR 


many consumer weather stations. These 
are the recommended sensors to use, as 
they are robust and reliable. Their data 
sheet (magpi.cc/ibPeBX) gives more 
information about the sensors’ size 

and construction. 
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| salient ny 


sit 


Anemometers normally have two wires. 
Connect one to a GND pin, the other to 
GPIO 05. If using the RJ11 connectors, 


from gpiozero import Button ~ 
, import time 
Q@3. import math 
Q4. 
Q@5. wind_count = 0 # Counts how 
many half-rotations 


the anemometer uses the middle two Q@6. radius_cm = 9.@ # Radius of your anemometer 
wires of the cable: normally pins 3 and 4 Q@7. wind_interval = 5 # How often (secs) to report speed 
on RJi1 breakout boards. e8. 
Q9. # eee half-rotation, add 1 to count 
STEP 23 10. def spin(): 
al global wind_count 
2 wind count = wind_count + 1 
13: # print("spin" + str(wind count) ) 
Open IDLE, create a new Python file, re SR ee eee 
and save it as wind_speed.py in the 1B. ee enane eieeaceine eee? 
/home/pi/weather-station directory. 17. -_ global ae CORE 
Add the code from the wind_speed.py 18. circumference cm = (2 * math.pi) * radius _cm 
listing. Save and run your code. Test 19. rotations = wind count / 2.0 
it by manually turning the arms of 20. = 


the anemometer. 2s # Calculate distance travelled by a cup in cm 


STEP 3 


22% dist_cm = circumference_cm * rotations 
23% 

24. speed = dist_cm / time_sec 

25. 

26. return speed 

27. 


The anemometer produces two signals 


| h b 28. wind speed sensor = Bu’ (5) 
Pig OP, SOGpn es ae tee tats lice 29. wind speed _sensor.when_pressed = spin 
of full rotations of the sensor by 30. 
halving the number of detected inputs. 31. # Loop to measure wind speed and report at 5-second intervals 
This can then be used to calculate the 32. while True: 
wind speed: 33. wind_count = @ 

34. time. p(wind_ interval) 

speed = distance / time 35. print x (wind_interval), “cm/h") 


To calculate speed, you need to know 


the distance travelled in a certain 
amount of time. Measuring time is 
fairly straightforward, and you can 
count the number of signals over 

the course of a fixed time period, 

for example 5 seconds. The distance 
travelled by one of the cups will be equal 
to the number of rotations multiplied 
by the distance around the edge of the 
circle (circumference): 


speed = (rotations x circumference) 
/ time 


The circumference can be calculated as 
long as you know either the radius of 
the circle. You can discover the radius 
made by the anemometer by measuring 
the distance from the centre to the edge 
of one of the cups. Once you know the 
radius, you can find the circumference 
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with the formula 2 x m x radius. Don’t 
forget that a whole rotation generates 
two signals, so you’ll need to halve the 
number of signals detected: 


speed = ( (signals/2) x (2 x m x radius) ) 
/ time 


The radius for the recommended 
anemometers used by the original 
Oracle Weather Station is 9.0cm, and 
that is the figure which is used in the 
code example. Don’t forget to change 
this value if your anemometer has 
different dimensions! 


To implement this formula in Python, 


you can use the h library. For 
example, if you measured 17 signals 
from your anemometer in 5 seconds, 


your wind speed could be calculated like 


the code in wind_speed.py. 


qs 


If you look inside the recommended 
wind vane, you’ll see eight reed switches 
arranged like the spokes of a wheel. 
These can be used to measure the wind 
direction. In order to do so, you’1l need 
LO Ded ble tO Mmed-Wte tie tiesiatanee 
produced by the sensor and convert that 
into an angle value. There are several 
steps in this process, and you need an 
analogue-to-digital converter (ADC). 
A popular and versatile ADC is the 
MCP3008 (magpi.cc/BIHIKm) 
Measuring the wind direction is a 
bonus project and you can read how to 
set up the rotating magnets and ADC 
here: magpi.cc/nZNLga. 
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BUILD A WEATHER STATION 


YOU CAN T STOP 
IT RAINING, 
, BUTYOUCAN 
- MEASURE IT IN 
A BUCKET 


Most rain gauges measure precipitation Station kit is actually a simple collected and channelled into the 

in millimetres in height collected on mechanical device included with the bucket. Once enough rainwater has 

one square metre during a certain Argent Systems Wind / Rain Sensor been collected, the bucket will tip over, 

time period. (magpi.cc/DWcYpV). the water will drain out from the base, 
The recommended rain gauge sensor This rain gauge is basically a self- and the opposite bucket will come up 

ee aed with the Raspberry Pi Weather emptying tipping bucket. Rain is into position. 
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STEP 1 


The product data sheet (magpi.cc/ItofJB) 
tells us that 0.2794 mm of rain will tip 
the bucket. You can multiply this by the 
number of tips to calculate the amount of 
rainfall. If you’re using a different type 
of rain gauge, then you should consult 
the relevant data sheet or determine the 
volume of water required experimentally. 


STEP 2 


The top of the back wall does come off if 
you want to see inside; just pull on the 
flat end gently and it should release. 
Inside there’s a small circuit board 
that you can remove to examine. In the 
middle of it you will see the reed switch. 
Replace the circuit board and back wall lid 
before continuing. 

When one of the buckets tips, the 
magnet passes the reed switch, causing 
it to close momentarily. So, just like with 
the anemometer, if you connect the rain 
gauge to a GPIO pin on the Raspberry Pi, 
you can treat it like a button and count the 
number of ‘presses’ to calculate rainfall. 


STEP 3) 


To test the rain gauge, you’ll need to 
either remove the RJ11 connector and 
Strip the wires, or make use of an RJ11 
breakout board. 

The Oracle Weather Station rain 
gauge is connected to GPIO 06, 
so for consistency, use the same 
pin for your device. (See the 
main Figure 1 circuit diagram on 
page 72.) 


quis 


Using the code you wrote for the 
anemometer as a Starting point, 
write a program called rainfall. py 
(saved in the /home/pi/weather- 
station directory) to detect when 
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the rain gauge bucket has tipped. It should 
print out a running count of how many 
bucket tips have occurred. 

Now that you can count bucket tips, 
you need to convert this into a height of 
water that equals the amount of rain that 
has fallen. 

Finally, we use a function named 
reset_rainfall to reset the count of 
bucket tips so that it starts at 0 again. 
You will need this function for your fully 
operational weather station. 


rainfall. py 


Q@1. from gpiozero import Button 
Q2. 

Q@3. rain_sensor (6) 

04. BUCKET SIZE 
Q05. count = 9 
Q6. 

Q7. bucket_tipped(): 


9.27/94 


8. global count 

09. count = count + 1 

10. (count * BUCKET SIZE) 

11. 

2s reset_rainfall(): 

de global count 

14. count = @ 

ise 

16. rain _sensor.when_pressed = 
bucket_tipped 


STORING 


One of the best ways to store 
your weather data is ina 
database. Databases can store 
very large numbers of records 
efficiently and make it easier 
to sort, search, and analyse 
your data. 

There are many different 
pieces of database software, 
and MariaDB is a good, versatile 
general-purpose product. You 
should have already installed 
it — if not, head back to the 
‘Software download’ section on 
page 71 and install it. 

Now follow the instructions at 
to learn how to 
set up and run your database. 
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NOW THAT YOU HAVE ALL YOUR COMPONENTS WORKING, IT'S TIME TO 
TURN THEM INTO A DEVICE THAT GAN LIVE IN THE GREAT OUTDOORS 


So that your weather station can upload typically the easiest way to do this, but connectivity on your Raspberry Pi at 

data to somewhere you can view and you can use the Ethernet connection if magpi.cc/fTclJO, and some special hints 
analyse it, it will need some form of that works better for your location. for getting wireless access working with a 
juceruet connection. Using WiFi is There’s a guide about setting up wireless | weather station are at magpi.cc/klShuT. 
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KEEP IT DRY 


Find two waterproof enclosures: one 
larger one for the Pi and the breadboard 
or HAT, and another smaller one for the 
BME280 sensor. The larger box should 
have a couple of holes for the RJ11 cables 
connecting the wind and rain sensors, 
and for some long wires to the BME280. 
If using the recommended enclosures 
(see p70), you can use this 3D-printable 
mount (magpi.cc/aadkGv) to secure the 
Raspberry Pi inside the larger box, and 
this one (magpi.cc/rGSAQc) to hold the 
BME280 sensor in the smaller one. 


STEP 2 
SEAL IT UP 


Use short self-tapping screws to secure 
the mounts into the holes and/or 
grooves at the back of the larger box. 

In order to get representative readings 
for ambient temperature and humidity, 
air needs to circulate around the BME280 


It is not possible to provide specific 
instructions for mounting your 
station, as the exact method will 
depend on your particular location 
and environment. However, here are 
some tips for a couple of aspects 

of the process that should help you 
get started: 


- Installing your Weather 
Station outside: wind sensors 
(magpi.ce / Pxbabil. 


- Installing your Weather Station 
outside: connecting to WiFi 
(magpi.ce/jujoYP). 


You may not be able to find an ideal 
location. Perhaps trees block the 
wind, or the rain gauge is partially 
sheltered by an overhang. Don't 
worry, just install your weather 
station anyway. 


ao 
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sensor. Remove both hole covers from 
one side of the smaller box. You can then 
pass the wires for the sensor up through 
one hole. Make sure you mount this box 
outside with the holes facing downwards 
so that rain cannot enter this way. 

Use waterproof nylon cable glands to 
prevent moisture entering the enclosure 
through the holes used for the cables. 


STEP 3 
PLUG THE HOLES 


The larger recommended enclosure has 
holes on all four sides that are sealed 
with rubber plugs. Use three of these 
holes along the bottom of the box to 
provide an escape route for your cables. 
Use an M16 cable gland in each of the 
two outer holes and pass the cable for 
the rain gauge through one and the cable 
for the wind sensors through the other. 

Use the larger M20 gland for the 
centre hole and feed the power cable, 
DS18B20 probe, and the wires for the 
BME280 sensor through. 


STEP 4 
CRACKIN’, GROMMET 


The hole in the M20 is quite large, so you 
should pad the cables to ensure a tight 
fit. A3D-printable grommet is available 
at magpi.cc/PrfCnV. Use two grommets 
rotated at 180 degrees to each other so 
that there is no gap all the way through. 


STEP 5 
MOUNTED OUTSIDE 


You could mount your station on a wall, 
rooftop, fence, or even on a plumbing 
pipe stuck in the ground. The larger box 
can be installed inside, to help keep it dry 
and allow easier connection to power and 
networking. However, the various cables 
for the external sensors (rain gauge, wind 
vane, anemometer, and BME280) will 
then all need to be routed inside, so this 
may involve a bigger hole in an external 
wall. Mounting everything outside means 
you only have to supply power to the 
weather station (assuming you are using 
wireless connectivity for data transfer). 


STATION HAT 


You should now have a working 
weather station prototype ona 
breadboard. For a more robust, 
long-term installation, or if you 
don’t have room for a breadboard 
in your enclosure, you can construct 
a weather station HAT (hardware 
attached on top) for your Pi. This 
will involve some soldering — if 
you’ve never soldered before, 
Raspberry Pi has a great resource 
plus video tutorial to get you started: 
magpi.cc/VKGfig. 
Note that to really be able to call it 
a HAT, your board should include a 
programmed EEPROM. The Adafruit 
Perma-Proto HAT kit does come as 
a variant with an EEPROM, so this 
is definitely something you could 
do, although we aren’t covering 
the procedure in this guide. A 
good place to start is this GitHub 
repository (magpi.cc/ILpFCS), or 
this article (magpi.cc/iAEnXI). 
If you want to turn the 
components into a HAT, then 
follow these instructions: 
magpi.cc/INdatp. 


FINAL APVICE 
Don’T FORGET 


- The rain gauge needs to 
collect rain. 


- The anemometer and wind 
vane need to be in the wind. 


- The smaller BME280 box 
needs to breathe - try to avoid 
situating it in direct sunlight. 


» The weather station needs to 
be connected to power, and to 
a network (wirelessly or via an 

Ethernet cable). 
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Waker 


says 


YetiBorg 


v2 Is gd great 
kit to get 

Started with 
Raspberry Pi 


robotics! 
PiBorg 


YET 


CAMJAM 
EDUKIT 3 


A beginner's kit 
that's slightly 
more suitable 
for true novices. 
The price is 
very attractive 
as well. 


£18 / $24 
magpi.cc/28KDW9S 
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YETIBORG V2 


ORG V2 


Rob Zwetsloot looks at the new YetiBorg robot kit. 
Does its diminutive size make it better for beginners? 


ast month in The MagPi 
we took a look at the 
DiddyBorg v2 robot kit 
from PiBorg. This relatively large 
kit from the PiBorg team is a 
fantastic, robust robot kit that is 
fantastic for veteran Raspberry Pi 
robot builders wanting something 
a bit more advanced to play with. 
We don’t think it’s the best kit 

to choose for beginners, though, 
which is where the YetiBorg v2 
comes in. 

In comparison to the DiddyBorg, 
it’s pretty small, although it’s 
definitely not the smallest Pi 
robot kit out there. Unlike other 
beginner-friendly robot kits, it 
includes all the high-quality parts 
and chassis you’d expect froma 
PiBorg kit. This quality comes at 
a price, though, and at £160 it’s 
quite a bit more than your classic 
robot starter kit. 


Construction is pretty simplified, 
with a fantastic step-by-step guide 
that takes you through the entire 
build process. There’s no soldering 
involved as it comes complete 
with pre-soldered motors and 
a Raspberry Pi Zero with a pre- 
soldered GPIO header. We received 
our YetiBorg fully constructed, in 
fact, but we estimate you’d be able 
to build it in under an hour, and 
the software won’t take you long to 
sort out either. 

This kit comes with a ZeroBorg, 

a quad motor controller designed 
with the Pi Zero in mind. While 

it may be smaller than the 
ThunderBorg controller used in the 
DiddyBorg, the ThunderBorg is only 
able to control two (or two sets of) 
motors at a time. This means the 
YetiBorg is truly a four-wheel-drive 
robot. Like the ThunderBorg, you 
can stack ZeroBorgs to add more 


motor controls if you wish, and 
while it is designed around the Pi 
Zero form factor, there’s no reason 
you can’t use it with a full-sized 
Raspberry Pi if you so wish. 


High performance 
The YetiBorg comes with example 
Scripts to get you started, including 
a remote control script using a 
game controller, a web interface 
that lets you see through a 
mounted Pi camera (not included), 
automated scripts, and more. 
You can use these to learn how 
the robot works and then cobble 
together your own scripts so the 
robot will do as you wish. 

While the ZeroBorg code is 
still quite complex as per the 
ThunderBorg code, it’s a bit easier 
to understand overall. It’s no 
GPIO Zero but it’s still readable, 
although we suggest that you 
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already have a basic grasp of that it’s for people getting into 


Python before tackling it. Raspberry Pi robotics; however, 
Still, it’s quite fun to have the we’re not quite convinced that it 

YetiBorg trundling around using is. At least, we wouldn’t say it’s 

a game controller. It’s not super- well suited to kids or teens looking 

quick either, so you won’t have any to learn about the Pi, computing, 

problems with it running off your and robotics with a Raspberry Pi 


With its ZeroBorg quad motor 
controller, the YetiBorg Is truly 
a four-wheel-drive robot 


table or smashing into walls, andthe robot kit. The barrier for entry with 


extra functions with the example the code is just a little too high 
remote-control script — suchas a compared to other robot kits we’ve 
button to reduce your speed — give used in the past. 

you an idea of how you can program However, we do think it’s quite 
and control the YetiBorg. well suited for adults confident 


in their computing skills who 
Friendly for beginners? — want to try their hand at robotics 
One of the selling points of the with a Raspberry Pi. The simple 
YetiBorg over the DiddyBorg is setup allows anyone to get it up 
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YETIBORG V2 


£160 / $224 


> 


and working pretty quickly, while 
the example scripts help you to 
become familiar with the ZeroBorg 
libraries. Whereas kids’ robot 
kits tend to be a bit cheap and 
disposable, the YetiBorg works well 
as a basic platform to then grow 
from, rather than throwing it away 
when you get your new robot kit. 
As for younger makers, while it 
may not be a good first kit, it could 
perhaps make an excellent second 
kit to really learn about the ways 
of Raspberry Pi robotics. 


fast word 


More of an adult beginner's kit than a young 
maker's kit, this robot is still a great product from 


the PiBorg team for those wanting something 
smaller than the DiddyBorg. 
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Waker 
days 


Ads can 
be blocked 


on any 
device and 


even in apps 
Pi Supply 


PI-HOLE 
FOSS 


Alternatively, to 
build your own 
Pi-hole server 
with an existing 
Raspberry Pi, 
you can install 
the free and 


open-source 
Pi-hole software. 


Free 
pi-hole.net 
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PI-HOLE 


PI-MOLFE, 


THE NETWORK-WIDE AD BLOCKER 


Block annoying internet adverts using this pre-built Pi kit 


illed as a black hole for 

internet adverts, Pi-hole 

is free and open-source 
software for the Raspberry Pi. 
While you could create your own 
Pi-hole server, Pi Supply’s kit 
comes pre-built and is almost a 
plug-and-play device. Inside the 
Sleek, branded black case - also 
available separately for £15 — is 
a Pi 3 and 16GB microSD card 
with Pi-hole pre-installed (in 
Raspbian). You also get a power 
supply, plus HDMI and Ethernet 
cables. An online setup guide is 
provided at pisupp.ly/pihole. 

Initial setup involves wiring the 

Pi-hole device to your router and 
connecting it toa TV. While Pi-hole 
is pre-installed, you need to set it 
up for your network. A Terminal 
command brings up a setup wizard, 
which prompts you to input your 
router’s IP address and set a static 


IP for the Pi-hole. You can then 
run the device as a headless server, 
with a wired or wireless connection 
to the router. 


Enable ad blocking 
The main way to enable network- 
wide ad blocking is to set your 
router’s DNS address to that of the 
Pi-hole. However, some routers 
(including ours) don’t permit 
users to change the DNS setting. 
One alternative is to disable the 
router’s DHCP server and enable 
one on the Pi-hole. This seemed 
a little daunting, so we opted to 
instead set the DNS address to 
Pi-hole’s IP manually on each 
device — a more flexible option. 
We soon encountered a problem, 
however: no webpages were 
loading! After a lot of Googling and 
head scratching, we eventually 
found a setting in the Pi-hole’s 


web interface: changing the 

DNS listening behaviour to ‘all 
interfaces’ instead of ‘etho’ did 
the trick (since our Pi-hole wasn’t 
wired to the router). The web 
interface is also very handy for 
seeing how many web queries have 
been blocked, viewing a query log, 
and black/whitelisting any that 
should be blocked/unblocked. 


fast word 


While setup wasn't quite as 
easy as we'd hoped - including 
having to set a new password 
to log in to the web interface 


- the Pi-hole device worked 
really well on the normally 

ad-heavy sites we tried. Yay, 
no more autoplay video ads! 
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Raspberry Pi 3 B+ finds a new 
home 


Versatile enclosure for Raspberry Pi 3 B+ 


The new UCS-RPI Universal Case System is compatible with the recently launched 
Raspberry Pi model 3 B+. It has pre-milled side walls for easy access to the I/O and 
power inputs and is available in black or grey and two sizes. Complete with glue dot 
location posts to secure the single board computer to the case. 


For additional information call 0845 881 2222 or visit 
phoenixcontact.co.uk/UCS-RPI 
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INSPIRING INNOVATIONS 


B4 


RASPBERRY PI 
BESTSELLERS 


ClojureScript, along with JavaScript’s 
functional features, enables more robust and 
responsive web apps in a ‘serverless’ world. 


BEGINNING 
FUNCTIONAL 
JAVASCRIPT 


Author: Anto Aravinth 
Publisher: Apress 
Price: £23.99 

ISBN: 978-1484226551 
magpi.cc/ RXKNXL 


If you're an OO programmer 
struggling with the concepts of 
functional programming, Aravinth's 
explanations should help make 
things clear. A second edition with 
better editing would be welcomed, 
but the author's knowledge and 
enthusiasm will carry you past 
grammatical errors. 


QUICK CLOJURE 


Authors: Quick Clojure 
Publisher: Mark McDonnell 
Price: £22.99 

ISBN: 978-1484229514 
magpi.cc/fEJHMU 


If you'd rather get the basics 
of Clojure under your belt 
before tackling ClojureScript 
(or a Clojure web server-based 
project), this concise guide is 
a truly enjoyable introduction 
to all the bits of the language 
that you'll really need. 


REACTIVE WITH 
CLOJURESCRIPT 
RECIPES 


Author: Nicolas Modrzyk 
Publisher: Apress 

Price: £31.99 

ISBN: 978-1484230084 
magpi.cc/xXjmjs 


ClojureScript is a Clojure that 
compiles to JavaScript and, as 
Modrzyk shows here, works 

well for functional reactive 
programming (FRP). The recipe 
book approach works well 

- allowing for beginner and 
relatively advanced topics to rub 
along well together. 
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HEAD FIRST 
LEARN TO CODE 


Head Firgt 


Author: Eric Freeman 
Publisher: O'Reilly 
Price: £39.99 

ISBN: 978-1491958865 
magpi.cc/lTnVbT 


There are many books on 
learning to code with Python, and 
several of them are actually fun - 
and we’ve really enjoyed reviewing 
them — but the latest book in 
O’Reilly’s excellent Head First series 
stands out. The first chapter is 
about ‘Thinking Computationally’ , 
and combines an introduction to 
what programming languages are 
and how they work, with an easy 
and practical introduction to some 
Python code. Nicely done, and very 
beginner-friendly. 

Variables are introduced with a 
dog age calculator program, then 
Booleans and control structures 
are explained with Rock, Paper, 


STATISTICS WITH R: 
A BEGINNER'S GUIDE 


STATISTICS Wity R 


4 BEGINNER'S Guide 


q 


s 


Author: Robert Stinerock 
Publisher: Sage 

Price: £100 

ISBN: 978-1473924895 
magpi.cc/jKQuZz 


A student textbook 
which introduces 
Statistics and analytical skills 
through the R language, reflecting 
the change in teaching even dry and 
conceptual topics like statistics. 
Indeed, knowledge of R is close to 
essential for those looking to learn 
Statistical methods and start a 
career in finance, pharmaceuticals, 
or even the civil service. This 
book is differentiated from many 
R introductions in being solidly 
erounded in teaching everything a 
first-year student of statistics needs 
to know. 

Tabular, graphical, and numerical 
methods in statistics lead on 
to problems in probability that 
depend upon them, and a look 


ROBERT STINEROCK 


Scissors. After lists, functions, 
and a look at the bubble sort 
algorithm, there’s a substantial 
project which puts everything 
together, and involves slicing 
strings and lists to measure the 
readability of texts — playing to 
Python’s strengths. 

Six more chapters build on 
readers’ achievements and give 
the skills and techniques needed 

for programming, from making 
reusable code and working with 
the file system, via recursion, to 
interacting with web APIs and 
building a graphical user interface. 
From using Turtle graphics to 
represent location data from 

the International Space Station, 

to canine humour in the OOP 
chapter, Freeman keeps this fun 
and engaging. Great for adults 
who want to learn to code, but also 
recommended for teen learners. 


at everything from sample space 
to Bayes’ theorem. Discrete and 
continuous probability functions 

lead on to binomial probability 
distribution — concepts again 
reinforced with the exercises. More 
advanced topics, such as hypothesis 
testing and multiple regression, 

are introduced after the appropriate 

foundation knowledge. A very 

comprehensive introduction. 

The formal textbook approach 
carries the penalty not just of a 
certain dryness that might make 
difficult reading for those who’ve 
become used to programming 
books leavened with humour, but 
also an eye-watering textbook 
price, although it’s also available 
as a paperback for £34.99. For 
those not constrained by budget, 
this is a good guide indeed — clear, 
well structured, and featuring well 
chosen examples and exercises. 
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DEEP LEARNING 
WITH PYTHON 


Author: Francois Chollet 
Publisher: Manning 
Price: £39.99 

ISBN: 978-1617294433 
magpi.cc/cvqSKy 


Francois Chollet is 
the originator of 
the Keras deep learning library, and 
wrote this book to address the need 
for a course to “simultaneously 
cover fundamentals of deep 
learning, Keras usage patterns, 
and deep learning best practices.” 
This user-friendly, open-source, 
high-level neural networks API was 
developed “with a focus on enabling 
fast experimentation,” enabling 
quick learning and testing of ideas. 
The Keras project has excellent 
documentation, but Chollet’s book 
provides a great introduction to 
machine learning, neural networks, 
and best practices for deep learning. 


20 EASY 
RASPBERRY Pl 
PROJECTS fgw 


Authors: Rui Santos 

& Sara Santos 
Publisher: No Starch 
Price: £21.99 
ISBN: 978-1593278434 
magpi.cc/ MEAAvk 


For beginners fascinated by the 
possibilities of fun, simple projects 
on the Raspberry Pi — or educators 
without an electronics background, 
looking to learn and get teaching 
examples — this colourful and 
well-laid-out introduction could 
be ideal. The 20 practical project 
tutorials include details of cost, 
time needed, parts list, basics 
electronic knowledge (practical, 
not theoretical), and what you can 
do to take it further. 

Projects start with LED basics, 
then add mini screens (Pong, 
weather forecaster), sensors, 
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7 RASPBERRY py fl 
. Preece ” 


Example-led explanations are clear, 
and the total beginner to the field 
is quickly learning quite advanced 
topics without fear - with 
examples to take to real- 
world problems. Appendices 
cover not just installation, 
but running examples in 
Jupyter notebooks with 
cloud-backed GPUs. 
It’s less maths-heavy than 
many deep learning books, 
but for most that will bea 
selling point. Certainly, Chollet’s 
explanations and examples will 
give you most of the knowledge you 
need, with a lot less mental strain, 
and readers prepared to tackle 
some of the more mathematical 
books may benefit first from some 
practical experience found here. 
Broadly recommended for anyone 
looking to dive into the exciting field 
of machine learning. 


Score 


camera (burglar detector with photo 
capture), web apps, and toys and 
games. One of the highlights in 
the latter section is the 
Digital Drum Set. The 
photography is extremely 
clear, helping beginners to 
follow the circuits easily. 
oassoe Along the way, Python 
“ code is given, and 
explained line-by-line 

where appropriate. There’s 
enough Python intro text 
to explain what you’re doing, but 
it’s not a full coding intro — just 
the right amount of information to 
aid those who want to get on with 
making things, and learn as they 
eo. There’s also a Scratch game, 
controlled by two push-buttons. 
It’s interesting to see Scratch 
introduced towards the end of 

a book, and liberating to not be 
bound by the idea that graphical 
comes before text-based. 


Score 


ESSENTIAL READING: 
SUMMER READING 
ESSENTIALS 


Summer means downtime - perhaps a 
beach holiday - and time to read and think. 


The Code Book 


Author: Simon Singh 
Publisher: Fourth Estate 
Price: £10.99 

ISBN: 978-1857028898 
magpi.cc/jtCAbf 


An eminently readable and 
understandable guide to codes and 
code-breaking, from ancient ciphers 
to PGP and quantum cryptography. 


The Hardware Startup 
Authors: Brady Forrest, Renee DiResta 

& Ryan Vinyard THE 
Publisher: O'Reilly HARDWARE 
Price: £27.99 STARTUP 


ISBN: 978-1449371036 
magpi.cc/IZZQNQ 


Practical guide to knowing your 
market, funding, developing your 
product, and manufacturing: is your 
project a viable business? 


Lauren Ipsum 


Author: Carlos Bueno 
Publisher: No Starch 
Price: £13.50 

ISBN: 978-1593275747 
magpi.cc/Eowlip 


IMPROBABLE THINGS 
CARLOS BUENO @ 


Great to see the kids reading anything, 
but this (and The CS Detective, also 
from No Starch) will entertain and 
educate simultaneously. 


Clean Architecture 


Author: Robert C. Martin , = 
Publisher: Prentice Hall Clean Architecture 
Price: £27.99 : = 
ISBN: 978-0134494166 > 


magpi.cc/ShtTnu 


Insightful collection of software 
architecture advice from Uncle Bob - 
principles and techniques which will 
help any project. 


If Hemingway Wrote JavaScript 


Author: Angus Croll 
Publisher: No Starch AR 
Price: £15.99 HEMINGWAY 
ISBN: 978-1593275853 WROTE 
magpi.cc/xNKMLo JAVASCRIPT 


A coding book you could read on the 
beach - humour and style insights 
with code by everyone from Calvino to 
Chaucer [allegedly!]. 
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THE MONTH IN 
RASPBERRY PI 


~ THE CHALLENGE 
OF TRANSLATION 


KAT LEADBETTER TELLS US 
HOW YOU CAN HELP CODE CLUB 


ai ia 
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FEATURE 


t Code Club and CoderDojo, we’re always 
working towards our long-term mission: to 
start Code Clubs and Dojos in every community 
on Earth. As part of that, we’re committed to helping 
as many children as possible access our resources in 
their native languages. The challenge? There are more 
than 6000 languages spoken around the world today... 

When Code Club and CoderDojo began to expand 
outside the UK and Ireland, amazing members from 
across the community realised the need for translated 
materials and stepped forward to offer their help. 
Thanks to these volunteers, we have since translated 
projects into more than 20 languages, from Croatian to 
Chinese and Portuguese to Polish. 

“Last year, I translated Code Club projects into 
Chinese,” says volunteer Jarod Yv. “Now kids can read 
the project articles by themselves and follow the tasks 
to create their own programs step-by-step. They get 
more coding practice and improve their programming 
skills rapidly.” 

With our increasing number of translations, 
volunteers are also motivated to make the most of the 
projects they have worked on. Code Club volunteer 
Marcus is planning to start using Welsh translations in 
his club, Layla will use Farsi translated projects in Iran, 
while Venancio is keen on making Raspberry Pi better 
known in Colombia. 

Our volunteer translators come from all backgrounds, 
professions, and walks of life. No technical or coding 


AND CODERDOJO TRANSLATE 
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knowledge is needed! Translating is also a great way to 
get involved if you have language skills but don’t have 
the time to volunteer at a regular Code Club or Dojo. 
Translators give a couple of hours of their time each 
week, but it’s up to you when you decide to work on 
translations. Depending on your English skills, we can 
also match you up with tasks that best suit your ability 
and confidence level. 


How does translating work? 

To make our translation process as easy and efficient 
as possible, we use the latest technology. Machine 
translation uses artificial intelligence to translate 
phrases automatically, without the help of humans, 
and translation memory Saves all previous translations 
and suggests them to translators who are working on 
something similar. 

Translators use an online platform called Crowdin, 
which combines these technologies in one place and 
provides an easy and intuitive editor for translators 
to work in. Projects are first translated with machine 
translation, after which a volunteer checks translation 
and makes any necessary changes. The project then 
goes through two other steps (review and test) to help 
us make sure that the quality of the final translation 
is excellent. At each step of the process volunteers are 
supported by our amazing Translations Manager, Nina, 
and there is also a community of other translators 
ready to give you a hand. 
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MAJA MANOJLOVIC 


Language: Croatian 
Way Number of projects translated or reviewed: 23 


I’m a student at the University things, engage in interactions 

of Rijeka in Croatia. My college with other volunteers — the list 
professor suggested I help is endless! The fact that you are 
translate Code Club projects helping children all over the world 
as a part of my M.A. thesis - to learn coding is also a reward 
since I am majoring in English in itself! 


and Informatics, it was a great 
opportunity to connect both my 
majors and gain more experience 
in translating! 


What advice would you give to 
others thinking about translating? 
I would encourage anyone who 
has any interest in translating or 
coding to get involved, because 
itis a great way to engage in 
something fun and new. You 

will learn so much, explore new 


( 


KARL SCHUH 


4M | o\guage: German 
Number of projects translated or reviewed: 40 


How did you start translating: What advice would you 

I think through The MagPi. Late give to others thinking 

in 2016 I had a go at translating about translating? 

the Code Club project ‘Happy I really like to translate. It is 
Birthday’ and last year I got an quite easy to do if you are a bit 
email from Code Club and decided _ of a techie and it gives you a 

to get involved again. My main eood feeling to bring children 
motivation was to go over the an interesting and creative way 


basics of using a Raspberry Pi and to spend their time. My advice: 
learn about some simple exercises just start doing it! It is anice 


which could be used for teaching community and all of us are 
adults, if the need for it came up willing to help newbies. 
at my job. 


What have you found most 
rewarding about translating? 
Translating pushes me to polish 
up my knowledge of the English 
language. I understand uncommon 
phrases and words I didn’t 

know before. 
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COR GROOT 


Language: Dutch 


way Number of projects translated or reviewed: 52 


How did you start translating? 
Since my retirement I have 
volunteered at a hackerspace 
where we introduce students from 
primary schools to everything from 
soldering, to coding with Scratch 
and robotics. For the computer- 
related workplaces, I developed 
all the lesson packages and found 
how difficult coding in English 
can be for Dutch youth. I started 
looking at how I could contribute to 
changing that. 

Because I play a lot with 
Raspberry Pi and Arduino, | 
soon came into contact with the 


SILVIA CAPONIO 


Number of projects translated or reviewed: 45 


q Language: Italian 


I’m a 23-year-old language 
enthusiast from Bari, southern 
Italy. At the moment I’m studying 
for my Master’s at the University 
of Sheffield, specialising in — you 
euessed it — Translation Studies. 


How did you start translating? 
When my professor said Raspberry 
Pi was looking for volunteer 
translators, I immediately signed 
up. Their projects introduce 

young people to computing and 
digital making, and develop their 
problem-solving skills in a fun 
way — something I strongly support. 
Through the projects I found out 
about Code Club and CoderDojo, 
and I found myself immersed in 
an amazing, positive community 
of people who work hard and 
collaborate and communicate with 
each other every day. 
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Raspberry Pi Foundation, as well as 
Code Club and CoderDojo. That led 
me to join the translation group. At 
the moment I have translated and 
reviewed various projects for the 
Raspberry Pi, Scratch, HTML & CSS, 
and Python. 


What advice would you give to 
others thinking about translating? 
Translating is easy with the help 

of various translation sites on the 
internet, and we regularly chat 
within our translation group about 
the best translation for a sentence 
or subject. If you want to help us to 


introduce young people to coding, 
then join us, choose a project that 
suits you, and start translating! 
You’re helping children, you will 
learn a lot yourself, and most 
importantly: it’s fun! 


What advice would you give to 
others thinking about translating? 
Translating and localising technical 
texts for a younger audience is 

an incredibly fun, challenging, 
compelling task. The translation 
process seems complicated 

at first, but the guidelines are 
straightforward and you can always 
ask for help! My advice for any 
prospective volunteer who wants 
to join this brilliant community 

is — have fun! Don’t be afraid to 
ask for advice: everyone is there to 
help you! 
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CROWDFUND 


epthies ihe Here are some other great 
The best crowdfunding hits this ig ie h 
= month for you to check out... things we saw this mont 


Apparently this is Reddit 
user CHRISFRED's first Pi 
project — they've installed 
LEDs into the top of a cap 
to show during graduation. 
It cycles between 
different messages and 
images — hopefully it’s 
controllable so that when 
it's thrown into the air, 

the perfect picture can 
be taken. Especially as it 
will probably break as it 


NIBBLER CASE 1/0 crashes to the floor. 


This one is not specifically for a Raspberry Pi, but 

is a great way to organise your breadboard circuits 
for Pi projects. The case is made of laser-cut acrylic 
or wood depending on your choice, has magnetic 
catches, and comes with a little breadboard that fits 
perfectly inside. 


m= Y LETSROBOT.TV 


MOV 
If you've not heard of them before, the Let’s Robot 
team put up video streams with their robots which the 
viewers can control. Now you can steer a Pi-powered 
robot that cuts the lawn. This is frankly amazing - the 
grass will never have been so thoroughly cut! 


STACKABLE 


Isaac, 14, of Awesome 


8-RELAY CARD vs 


about his great new Pi 


A spin-off of the Mega-IO expansion card Wiimote-loT project on 
(kck.st/2eLc4no) that removes a lot of the GitHub. You can use it to 
functionality in favour of just including the relays. control Phillips Hue lights [iiamnanaal 


They can be stacked easily, which allows for greater and Sonos systems with a 
control of many more devices than what you can do Wii Remote, and we think 
with just the GPIO pins on their own. that's pretty cool. 
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Controlled 

by a PlayStation 3 
gamepad, Revenge 
is a six-wheeled 
A3 class robot 

that can cope 

with a host of 
different surfaces 
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When it comes to robots, 
Brian Corteil is a master maker 


f you’ve read The MagPi 
before, you’1l recognise 
Brian Corteil’s name. From 
tutorials and events, to online 
discussion and Pi parties, it’s likely 
you'll bump into him with a robot 
in one hand and some other mad 
creation in the other. 
Trained as an electrician, Brian’s 
interest in electronics came 
into play with the release of the 


Arduino and, later, the Raspberry 
Pi, after he was able to obtain one 
of the first 10000 Model Bs. By day, 
he’s an integrated security systems 
engineer, installing service access 
control, CCTV, and intruder 
alarms. And by night, Brianisa 
keen and successful robot builder. 

The annual Pi Wars challenge is 
where Brian’s robot-making skills 
truly shine. In fact, if you were to 
ever bump into Brian at his local 
Cambridge Makespace, he’d likely 
be tweaking his latest robot buggy 
or building new track for the main 
event. And the time and effort put 
in definitely has its rewards, with 
Brian taking first place in several 
of the pro courses of this year’s Pi 
Wars, missing out on overall first 
place by a mere one point. 


Robotics made easy 
Outside of Pi Wars, Brian is also 
the head of Coretec Robotics, 
responsible for the Tiny 4WD, a 
mini robot originally designed for 
The MagPi’s ‘Build your own Pi 
Wars robot’ feature in issues 51 and 
52. The success of the robot turned 
4WD into a consumer project kit 
that avid makers can buy and build 
themselves using laser-cut parts, 
a Raspberry Pi Zero W, a handful 
of electronics, and the Pimoroni 
Explorer pHAT. “I have to thank 
the salty sea dogs of Pimoroni 

for kicking me up the bum to get 
Tiny out in the wild,” he jokes 
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Micro Pi Noon pits balloon-clad 
robots against each other, with 
the last balloon holder standing 
hailed the winner 


when talking to us about Coretec. 
“Over the next year or so, I will be 
releasing helpful breakout boards 
for making robotics and making a 
little easier.” 

Brian also tries to attend as many 
events as possible, from Maker 
Faires to Raspberry Jams, and can 


When it comes to discussing his 
project builds and robots, Brian 
is first to list the people to whom 
he’s beholden. “T like to thank the 
people who have supported me in 
my adventures in making, first of 
all the members of Makespace for 
helping me turn my crazy ideas into 


Thousands of balloons have been 
sacrificed to the maker gods 


often be found demonstrating 
Micro Pi Noon, based on Michael 
Horne and Tim Richardson’s Pi 
Wars Pi Noon challenge. Two 
competitors battle to pop the 
balloons attached to each other’s 
robots; the last to retain an inflated 
balloon is the winner. “Thousands 
of balloons have been sacrificed to 
the maker gods,” he admits. 


working things,” he begins, before 
mentioning organisations such as 
Pimoroni, Tim and Mike (the minds 
behind Pi Wars), and makers Robert 
Karpinski and Mark Mellows “for 
checking my electronic designs and 
answering my silly questions and 
their help in being awarded a blue 
ribbon at this year’s Maker Faire UK 
in Newcastle.” 


Brian won a blue ribbon 
at this year’s Maker 
Faire Newcastle for his 
robot builds, including 
the six-wheel Revenge 
and A6-sized Tiny 
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EVENT CALENDAR 


Find out what community-organised, Raspberry 
Pi-themed events are happening near you... 


Want a Raspberry Jam in your 
area? Want to start one? Email 
Ben Nuttall to find out more: 


Jam@raspberrypi.org 


GTA RASPBERRY PI JAM 
When: Thursday 5 July 
Where: Civic Centre Resource 
Library, Vaughan, 
ON, Canada 
magpi.cc/CMhJUg 
Makers, tinkerers, coders, and 
lovers of playing with technology 
unite for this free Jam! 


SAHIWAL RASPBERRY JAM 

When: Monday 9 July 

Where: E-Rozgaar Center, 
Sahiwal, Pakistan 

magpi.cc/yHzkXy 

A Maker. pk-organised 

Raspberry Jam in Pakistan, one 

of two this month, and free 

for all to attend! 
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J lee OLIVE BRANCH 
a RASPBERRY JAM 
> 

ve 
FAISALABAD 
RASPBERRY JAM 


When: Thursday 19 July 

Where: University of Agriculture, 
Faisalabad, Pakistan 

magpi.cc/XcpdWu 

The second major Pakistani 

Raspberry Jam this month, 

which is also free for everyone. 


OLIVE BRANCH 

RASPBERRY JAM 

When: Saturday 28 July 

Where: B.J. Chain Public Library, 
Olive Branch, MS, USA 

magpi.cc/WxeYYR 

A free family event to learn 

about coding and play with 

the Raspberry Pi. 


3, 


FAISALABAD ee 
RASPBERRY JAM .. 


SAHIWAL 
RASPBERRY JAM 
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PRESTON 

RASPBERRY JAM 

When: Monday 2 July 

Where: Media Factory Building, 
Preston, UK 

magpi.cc/BvJeFL 

A community of people who meet 

to learn, create, and share the 

potential of the Raspberry Pi. 


OXFORD RASPBERRY JAM: 

EVENING FLAVOUR 

When: Tuesday 3 July 

Where: Oxford Centre For 
Innovation, Oxford, UK 

magpi.cc/XixtqF 


6-8 REGULAR EVENTS 


An evening meet-up for Raspberry 


Pi enthusiasts! Suitable for adults 
and accompanied young people. 
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Every Raspberry Jam is entitled to apply for a 
Jam starter kit, which includes magazine issues, 
printed worksheets, stickers, flyers, and more. 
Get the guidebook here: magpi.cc/2qSDHfQ 


an RASPBERRY JAM ADVICE 
RASPBERRY JAM 
When: Wednesday 4 July 
Leeds, UK PROMOTING YOUR EVENT 
magpi.cc/ZNNDeX 
activities through the workshop. Plus it useful to get the message directly to 
a hackspace area to share projects. schools who use Twitter, so the IT specialist 
VORK children. | think old-fashioned posters put 
RASPBERRY JAM up around the area work well too. 
Where: Acomb Explore Library, York Raspberry Jam 
Monk Wik 
York Pi Jam is an event for 
people of all skill levels who 


Where: Swallow Hill Community, 
Get hands-on with digital making | use Twitter and Facebook. I've found 

can pass the message on to parents and 
When: Monday 16 July Anne Cariill 
magpi.cc/hbfvvK 
want to learn more about the Pi. 
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LETTERS 


MUSICALLY —WO@)st= 
INIGRINDE THAN 


I’ve used a Raspberry Pi for a few years in | N Y 
different electronics projects — some robots, the 


odd automatic light, that kind of thing — but I’ve 
become interested recently in having my music I like using Raspbian on the 
controlled and played from my Raspberry Pi. Raspberry Pi, but I’m not very 
I know there’s the headphone jack and you can used to Linux and those types 
do digital audio via the HDMI port, but is there a of operating systems. I’ve also 
Way to get better audio out of the Raspberry Pi? seen that a lot of other operating 
With that in mind, would you say the Raspberry systems for the Pi are based on 
Pi is generally good for a jukebox or party music Linux. Is there any way I can use 
application? Whether you’re DJing or just letting Windows on my Raspberry Pi? 
it play from a playlist? Emilio 
Martin 


As the Raspberry Pi is mainly 
Among the most common add-ons we see for designed for education, using 
the Raspberry Pi are DACs that offer high-quality something like Raspbian is a 
audio output designed for sound systems. A lot ereat way for people to learn 
of them come as HATs which slot on top of the about computing and coding. 
Raspberry Pi, making it all very compact, and It’s also slightly easier to get a 
several include RCA jacks or optical out. Linux distribution to work on the 
There are plenty to choose from, but we quite 
like the Nanomesher series of DACs as they include 
a screen and you can get an optional 3D-printed 
case to fit them. 
As for DJing with one - the Raspberry Pi is just a 
computer, so as long as you can find software you 
like to use for it, you can play music as you wish. 
We’ve also seen Sam Aaron, creator of Sonic Pi, 
do live DJing with the music creation software. 
There’s plenty you can do with it! 


The NanoSound DAC Pro is 
one of our favourite recent 
DACs for better audio 
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While full Windows is not readily available 
for the Raspberry Pi, the loT Core version is 


Raspberry Pi due to its relatively 
low power and use of an ARM 
processor — Windows runs on 
x86 computers with much more 
powerful processors and such. 
However, while you won’t be 
getting a Windows 10 SD card 
like you would an installation CD 
for your computer, people have 
been figuring out how to hack 
Windows 10 to run on Raspberry Pi. 
It doesn’t run particularly well but 
if it’s good enough for you to use, 
we suggest taking a look into it. 
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FROM THE FORUM: 


ere in Africa, PDFs are a lot more 
practical than printed magazines. 
I have PDEs of The Official Raspberry 
Pi Projects Book — Volume 1 and 2, but can’t 
find Volume 3. Is this available to download? 
Where can I find it? 
DaveSemm 


Anyone having trouble finding the PDF for The 
Official Raspberry Pi Projects Book Volume 3 should 
head here: magpi.cc/projects3 — you’ll see a 
button that says ‘Download Free’ which lets you 
get the PDF for the book. 

This button can be found on every issue and 
book’s page on our website to get the PDF for 
free, to make it 
easier for people 
like you who 
cannot get the 
printed editions. 

VOU Calle ven 
read them on 
the Raspberry Pi 
as well! 


As well as every 

issue of the 

magazine, the 

Projects Books 

are available as “naghiog & 
a free PDF! 
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The Raspberry Pi Forum is a hotbed of conversations 
and problem-solving for the community — join in via 
raspberrypi.org/forums 


Sandbender 
Technology 


CAN Interface pHAT 


Easily turns a Raspberry Pi into a low 
cost CAN bus equipped controller. 


e SPI MCP2515 CAN Controller 


e Isolated CAN Transceiver 


*e 3 e Real Time Clock 


e Logging Memory 


www.sandbendertechnology.com 
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CAN YOU HELP INSPIRE © 
THE NEXT GENERATION 


OF CODERS? 


Code Club is a network of volunteers and 
educators who run free coding clubs for 
young people aged 9-13. 


ra! To find out more, join us at 


Code Club is part of the Raspberry Pi Foundation. Registered Charity Number 1129409 C5 


In association with 


& Astroprint 


ASTROBOX 
TOUCH & 
GATEWAY 


AstroPrint makes 3D printing easy with 
its AstroBox Touch and Gateway kits. 
These devices enable you to monitor 
and control a 3D printer from anywhere 
in the world. 


Most 3D printers come with very basic 
controls, and AstroBox uses a Raspberry 
Pi to add a professional software layer 
on top of a basic 3D printer. 


= AstroBox 


=-EE 


File Upload File Manager control 


Ze 


Thingiverse MyMiniFactory 3DPrintCloud 


Supplies 


With AstroBox you can download 3D 
printer files from a range of websites 
and print the models directly from 
your printer. 


Apps 


Enter now at magpi.cc/win 


Terms & Conditions 


Competition opens on 27 June 2018 and closes on 27 July 2018. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry 
Pi Foundation, the prize supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the 
competition, the winner consents to any publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from 
The MagPi magazine. We don't like spam: participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable 
and no cash alternative will be offered. Winners will be contacted by email to arrange delivery. Any winners who have not responded 60 days after the initial 
email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, or associated with, Instagram or Facebook. 
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Column THE FINAL WoRD 


MATT RICHARDSON 


Matt Richardson is the Executive Director of the Raspberry 
Pi Foundation North America and author of Getting Started 
with Raspberry Pi. Contact him on Twitter @MattRichardson. 


SHO 


any years ago at a Maker Faire, I received a 
bracelet with the words ‘Show what you make, 
share what you learn’ inscribed on it. Ever 
Since then, those words have stuck with me because 
they encapsulate such an important aspect of the 
Raspberry Pi community and the maker movement at 
large. We’re not acommunity only because we have a 
common interest in making things with technology. 
We’re acommunity because we generously share our 
projects and our knowledge. It’s an important part of 
the maker ethos and it’s why events like Maker Faire 
are such a key aspect of the movement. 


Meet and share 

As I’ve discussed here before, there’s a fantastic 
community of Raspberry Pi enthusiasts sharing 
projects and knowledge online on sites such as 

Reddit, Twitter, Hackaday, Make, and Instructables. 
But nothing quite beats face-to-face interaction for 
sharing and community-building. We at the Raspberry 
Pi Foundation want to provide opportunities for 
members of our community to see and meet each other 
and have the opportunity to share. 

For example, Coolest Projects is a showcase event 
for young people to share what they’ve created with 
technology. This event sprang from the CoderDojo 
movement and has become huge in Dublin over the 
past few years. We launched this event in the United 
Kingdom a few months ago and we’re excited to bring 
it to California in September for young digital makers 
in North America. More details about it can be found 
at coolestprojects.org/northamerica. 

For youth and adults in the Raspberry Pi 
community, Raspberry Fields is an opportunity to 
Share their projects, products, and anything related 
to Raspberry Pi. The event is new this year and takes 
place in Cambridge during the summer. Read more 
about it in this issue of The MagPi. And if you aren’t 
able to make it to Raspberry Fields this time around, 
check out the Raspberry Jam map (rpf.io/jam) for a 
Jam happening near you. 
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Matt Richardson 
on how sharing is a 


The purpose of events such as Coolest Projects, 
Raspberry Fields, Maker Faires, and Raspberry Jams 
is to give makers a platform to show their projects 
and share the knowledge they’ ve gained through the 
process of making. When a person creates something 
or figures something out, it’s natural for them to 
want to share that object and the experience of 
creating it with others. Have you ever solved a tough 
real-world problem and just couldn’t wait to tella 
friend about how you did it? Sharing that experience 
ereatly enhances the feeling of accomplishment. 


When makers share, 
it inspires, encourages, 
and educates others 


That feeling of accomplishment will give you 
motivation to continue creating and solving. 


Inspire others 

When makers share, it inspires, encourages, 

and educates others. | joined the maker movement 
after | saw the projects that others were making and I 
said to myself, “I wish I could do that too.” Because | 
was able to talk to those makers and hear the details 
about how they created their projects, I felt supported 
and encouraged to try it on my own. I went from 
wishing I could do it to actually doing it because of 
how much inspiration and knowledge those makers 
had shared. And now! don’t consider my own projects 
complete until I’ve shared them with the world. 

Could you even imagine what it would be like if 
members of our community didn’t share their projects 
and knowledge so freely? If that were the case, I don’t 
even think we could consider ourselves a community. 
Sharing is what makes us more than just a group of 
people with a common interest; it is what makes 
us acommunity. 
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critical part of creating 


THE Official 
RASPBERRY PI 
EGINNER’S BOOK 


THE EASY WAY! 


Pi Zero W computer 


Official case with three covers 
USB and HDMI adapters 

8GB microSD card 

116-page beginner’s book 
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Build your own credit card 
sized computer 


Get started with Programming 
Set up a Media Center 


Make simple electronic circuits 


Raspberry Pj board and case 


Power supply and HDMI Cable 
Pre-Programmed 
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DUMMIES 


Available in Europe 
Available for worldwide shipping at: through RS Components 


$89° £69° 


US DOLLARS EXCLUDING VAT 


Raspberry Pi is a registered trademark of the Raspberry Pi Foundation. 
For Dummies and the Dummies Man logo are trademarks or registered 
trademarks of John Wiley & Sons, Inc. Used under license. RS logo is 

a registered trademark of RS Components Ltd. Canakit is a registered 
trademark of Cana Kit Corporation. 
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